django-req-generator 0.1.5

Advanced requirements.txt generator for Django. Self-healing, PyPI dynamic mapping, and venv validation.

django-req-generator

Generador avanzado de requirements.txt / Advanced requirements.txt generator

---

🇲🇽 Español

Descripción

Este plugin para Django sirve para empaquetar tu proyecto e instalarlo de forma limpia en otros entornos (Docker, Servidores de Producción, CI/CD). Está específicamente diseñado para manejar proyectos Django complejos donde no basta con un simple pip freeze.

Características Principales

• 🔍 Análisis Estático (AST): Detecta imports reales en todo el árbol de tu código fuente.
• 🧩 Inspección Profunda de Django: Analiza INSTALLED_APPS, MIDDLEWARE, DATABASES (detecta drivers como oracledb), y CACHES (detecta django-redis y pymemcache).
• 🧹 Limpieza Automática: Filtra la librería estándar de Python y tus propios módulos locales (apps, models, serializers, etc.).
• 🔗 Resolución Dinámica PyPI: No usa mapeos manuales fallidos; pregunta directamente a la API de PyPI para encontrar el paquete correcto.
• 🤖 Auto-curación Interactiva: Durante la validación, si detecta un módulo faltante (ModuleNotFoundError) o un fallo de Pip, te pregunta si quieres corregirlo y reintenta la validación en caliente.
• 🧪 Validación en Venv: Crea un entorno virtual temporal para asegurar que el archivo generado permite que el proyecto arranque.
• 🌎 Multilingüe: Soporta comandos y mensajes en Español e Inglés.

Instalación

1. Instala el paquete:

pip install django-req-generator

2. Regístralo en Django: Añade django_req_generator a tus INSTALLED_APPS en tu archivo settings.py:

# settings.py
INSTALLED_APPS = [
    ...,
    'django_req_generator',
    ...,
]

Nota: El plugin se detectará automáticamente a sí mismo y se incluirá en tu requirements.txt al generar el archivo.

Uso

# Generación estándar con backup automático
python manage.py generate_reqs

# Generación con validación y settings específicos
python manage.py generate_reqs --validate --settings=mi_proyecto.settings_docker

# Modo Desarrollo (instala el plugin desde código fuente en la validación)
python manage.py generate_reqs --validate -d /ruta/al/plugin

---

🇺🇸 English

Description

This Django plugin is designed to package your project and install it cleanly in other environments (Docker, Production Servers, CI/CD). It is specifically built for complex Django projects where a simple pip freeze isn't enough.

Key Features

• 🔍 Static Analysis (AST): Deep-scans your entire source code to detect actual imports.
• 🧩 Deep Django Inspection: Analyzes INSTALLED_APPS, MIDDLEWARE, DATABASES (detects drivers like oracledb), and CACHES (detects django-redis and pymemcache).
• 🧹 Automatic Cleanup: Filters out Python's standard library and your own local modules (apps, models, serializers, etc.).
• 🔗 Dynamic PyPI Resolution: Replaces outdated manual mappings by querying the PyPI API directly for the correct package name.
• 🤖 Interactive Self-Healing: During validation, if a missing module (ModuleNotFoundError) or a Pip failure is found, it asks if you want to fix it and retries the validation on the fly.
• 🧪 Venv Validation: Creates a temporary virtual environment to ensure the generated file allows the project to start.
• 🌎 Multilingual: Supports commands and console messages in both Spanish and English.

Installation

1. Install the package:

pip install django-req-generator

2. Register it in Django: Add django_req_generator to your INSTALLED_APPS in your settings.py file:

# settings.py
INSTALLED_APPS = [
    ...,
    'django_req_generator',
    ...,
]

Note: The plugin will automatically detect itself and include it in your requirements.txt when generating the file.

Usage

# Standard generation with automatic backup
python manage.py generate_reqs

# Generation with validation and specific settings
python manage.py generate_reqs --validate --settings=my_project.settings_docker

# Development Mode (installs plugin from source during validation)
python manage.py generate_reqs --validate -d /path/to/plugin

---

Made with ❤️ and AI Collaboration | Creado con ❤️ y el apoyo de IA