r-py

Crates.io	r-py
lib.rs	r-py
version	0.1.8
created_at	2024-12-02 20:49:34.25966+00
updated_at	2025-02-24 17:32:18.746181+00
description	Una herramienta CLI para gestionar y ejecutar comandos predefinidos desde archivos de configuración
homepage	https://github.com/HormigaDev/r-py
repository	https://github.com/HormigaDev/r-py
max_upload_size
id	1469199
size	28,407

ISAI MEDINA (HormigaDev)

documentation

https://docs.rs/r-py

README

CLI R-PY

r-py es una herramienta de línea de comandos ligera inspirada en el comportamiento de npm de Node.js, diseñada para proyectos de Python. Permite gestionar y ejecutar comandos complejos de manera más sencilla mediante alias configurables.

Con r-py, puedes definir comandos predefinidos en un archivo de configuración y luego ejecutarlos fácilmente con un alias. Esto hace que ejecutar tareas repetitivas sea más rápido y menos propenso a errores, sin necesidad de recordar largos comandos.

¿Cómo funciona?

Al definir tus comandos en el archivo de configuración cmd.ini al nivel del archivo binario (o sea donde se está ejecutando el CLI), puedes crear alias para ejecutar tareas frecuentes. Por ejemplo, en lugar de escribir el largo comando:

uvicorn app.main:app --reload

Puedes simplemente ejecutar:

rpy start

Ventajas

Simplificación: Olvídate de recordar y escribir comandos largos o complejos cada vez que los necesites.
Personalización: Puedes fácilmente modificar el comportamiento de tus comandos mediante la configuración de los alias.
Automatización: Organiza tus tareas en un solo archivo y ejecútalas con una simple llamada a rpy <alias>.
Versatilidad: rpy se adapta a cualquier proyecto Python, permitiéndote gestionar múltiples scripts de forma eficiente.

Comandos predeterminados

El binario de rpy incluye de forma predeterminada los siguientes comandos:

install [paquete]: Instala las dependencias de Python. Si no se proporciona un paquete específico (ejemplo: r-py install discord.py), se instalarán todas las dependencias listadas en requirements.txt.
init: Inicializa un proyecto básico de Python en el directorio actual, creando los archivos esenciales.
new : Crea un nuevo proyecto con el nombre especificado, generando una estructura de archivos inicial.

Ejemplo de uso

Crea un archivo cmd.ini en tu proyecto al nivel del binario donde defines los alias y los comandos correspondientes:

start=uvicorn app.main:app --reload
stop=killall uvicorn
test=pytest

Ejecuta el comando deseado:

rpy start

Esto ejecutara el comando uvicorn app.main:app --reload, de manera más concisa.

Instalación

Puedes instalar este binario de forma rápida ejecutando cargo install r-py

Para instalar y usar r-py, simplemente descarga el archivo binario en las versiones del repositorio o sigue estos pasos:

Clona el repositorio:

git clone https://github.com/HormigaDev/r-py.git
cd r-py

Compílalo con cargo (asumiendo que ya tienes el ecosistema de rust):

cargo build --release

Copia el binario a una ubicación accesible, por ejemplo:

sudo cp ./target/release/r-py /usr/local/bin/

Ahora puedes usar r-py desde cualquier parte de tu sistema:

r-py start

Contribución

Si quieres contribuir al proyecto, puedes hacerlo abriendo issues o pull requests en el repositorio de GitHub: https://github.com/HormigaDev/r-py.

License

Este proyecto está bajo la licencia MIT. Puedes ver más detalles en el archivo LICENSE.

Commit count: 13