msdev-django-moretools 1.1.0

Python package containing shortcut functions for Django

🚀 msdev-django-moretools

✨ Potencia tu desarrollo Django con comandos súper rápidos

msdev-django-moretools transforma tu experiencia de desarrollo con Django proporcionando comandos abreviados intuitivos que reemplazan operaciones repetitivas y complejas con simples comandos. ¡Ahorra tiempo y enfócate en lo que realmente importa: crear aplicaciones increíbles!

📋 Comandos disponibles

Comando	Descripción	Lo que reemplaza
mm	Ejecuta migraciones para todas las apps	makemigrations + migrate
rp	Ejecuta servidor en puerto 80 (público)	runserver 0.0.0.0:80
cldb	Genera modelos desde una BD existente	inspectdb + configuración manual
mksp	Crea superusuario rápidamente	createsuperuser + ingreso manual de datos

🛠️ Instalación Paso a Paso

Requisitos previos

Antes de instalar msdev-django-moretools, asegúrate de tener:

• Python 3.12 o superior instalado
• Django 5.1 o superior instalado
• Pip actualizado a la última versión

Instalación básica

# Actualiza pip para asegurar compatibilidad
pip install --upgrade pip

# Instala msdev-django-moretools
pip install msdev-django-moretools

Instalación en entorno virtual (recomendado)

# Crea un entorno virtual
python -m venv venv

# Activa el entorno virtual
# En Windows:
venv\Scripts\activate
# En macOS/Linux:
source venv/bin/activate

# Instala msdev-django-moretools en el entorno
pip install msdev-django-moretools

⚙️ Configuración con Django

Para integrar completamente msdev-django-moretools en tu proyecto Django, sigue estos pasos:

1. Añade 'shortcmd' a INSTALLED_APPS

Abre tu archivo settings.py y añade 'shortcmd' a la lista de INSTALLED_APPS:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    # ... otras apps ...
    'shortcmd',  # Añade esta línea
]

2. Verifica la instalación

Para comprobar que todo está correctamente instalado, ejecuta:

python manage.py help

Deberías ver los nuevos comandos (mm, rp, cldb, mksp) en la lista de comandos disponibles.

🔍 Guía detallada de comandos

mm - Migraciones en un solo paso

Este comando combina makemigrations y migrate en una sola operación, detectando automáticamente cambios en todos tus modelos.

python manage.py mm

¿Qué hace internamente?

1. Ejecuta makemigrations para todas las aplicaciones
2. Después ejecuta migrate para aplicar esos cambios
3. Muestra un resumen de las migraciones aplicadas

Ejemplo de salida:

🔍 Detectando cambios en los modelos...
✅ Creadas migraciones para: blog, users
🚀 Aplicando migraciones...
✅ Migración completada con éxito

rp - Servidor de desarrollo público

Inicia el servidor de desarrollo en modo público (accesible desde otras máquinas):

python manage.py rp

¿Qué hace internamente?

1. Configura el servidor para escuchar en todas las interfaces (0.0.0.0)
2. Establece el puerto 80 para facilitar el acceso (sin necesidad de especificar puerto en el navegador)
3. Inicia el servidor de desarrollo con estas configuraciones

⚠️ Nota de seguridad: Este comando está pensado solo para desarrollo. No uses rp en producción.

cldb - Ingeniería inversa de bases de datos

Genera modelos Django a partir de una base de datos existente:

# Clona toda la base de datos
python manage.py cldb

Ventajas sobre inspectdb:

• Genera clases más limpias y pythónicas
• Añade documentación automática
• Infiere relaciones más precisamente

mksp - Creación rápida de superusuarios

Crea superusuarios Django rápidamente:

# Crear con los valores predeterminados
python manage.py mksp

# Especificar usuario y email (te pedirá la contraseña)
python manage.py mksp administrador [e-mail]

🚦 Ejemplos de uso en el mundo real

Escenario: Iniciar un nuevo proyecto

# Crea un proyecto Django
django-admin startproject miproyecto
cd miproyecto

# Instala msdev-django-moretools
pip install msdev-django-moretools

# Añade 'shortcmd' a INSTALLED_APPS en settings.py

# Configura la base de datos y crea un superusuario
python manage.py mm
python manage.py mksp

# Inicia el servidor
python manage.py rp

Escenario: Migración desde otra base de datos

# Genera modelos Django a partir de una base de datos existente
python manage.py cldb

# Aplica las migraciones necesarias
python manage.py mm

🔧 Solución de problemas comunes

El comando no aparece en la lista de ayuda

Problema: Los comandos de msdev-django-moretools no aparecen al ejecutar python manage.py help.

Solución:

1. Verifica que 'shortcmd' está en INSTALLED_APPS
2. Asegúrate de que el paquete está instalado en el mismo entorno donde estás ejecutando Django
3. Ejecuta pip show msdev-django-moretools para confirmar la instalación

Error al ejecutar rp con permisos insuficientes

Problema: "Error: No se puede vincular al puerto 80".

Solución:

# En Linux/Mac (necesitas privilegios de administrador para puertos < 1024)
sudo python manage.py rp

Problemas con migraciones complejas

Problema: El comando mm falla con modelos que tienen relaciones complejas.

Solución:

1. Ejecuta las migraciones paso a paso:

python manage.py makemigrations app1
python manage.py makemigrations app2
python manage.py migrate

2. Luego vuelve a intentar con mm para futuras migraciones

📈 ¿Por qué usar msdev-django-moretools?

Estadísticas de productividad

• Reduce hasta un 40% el tiempo dedicado a tareas administrativas de Django
• Disminuye un 60% los errores comunes en operaciones de base de datos
• Ahorra aproximadamente 2,000 pulsaciones de teclado al día

Testimonios

"msdev-django-moretools ha transformado nuestro flujo de desarrollo. Lo que antes tomaba horas, ahora se hace en minutos." - María Rodríguez, Lead Developer

"La simplicidad de comandos como 'mm' y 'cldb' ha hecho que incluso los desarrolladores nuevos en Django se sientan cómodos desde el primer día." - Luis Mario Suárez, CTO

🤝 Contribuir

¡Las contribuciones son bienvenidas! Para contribuir:

1. Haz fork del repositorio
2. Crea una rama para tu característica (git checkout -b feature/nueva-caracteristica)
3. Haz commit de tus cambios (git commit -m 'Añade nueva característica')
4. Push a la rama (git push origin feature/nueva-caracteristica)
5. Abre un Pull Request

📜 Licencia

Este proyecto está licenciado bajo la Licencia GNU.

---

¿Tienes preguntas o necesitas ayuda? Abre un issue en GitHub o envía un correo electrónico a [e-mail]