Reloadium es una herramienta de desarrollo para Python que ofrece capaciddaes de recarga en caliente, profiling y depuración con IA. Su sistema de configuración permite adaptar el comportamiento de la herramienta a las necesidades específicas de cada proyecto, controlando desde los patrones de archivos monitoreados hasta los parámetros de muestreo de rendimiento.

Mecanismos de configuración disponibles

Reloadium acepta configuración a través de múltiples canales, cada uno con distinto nivel de granularidad y propósito.

Variables de entorno

# Configuración mediante variables de entorno
export RELOADIUM_FILE_TRACKER="*.py,*.pyx"
export RELOADIUM_EXCLUSION_LIST="cache/*,*.pyc"
export RELOADIUM_PROFILE_FREQUENCY=1000

Módulo Python

La opción más completa consiste en colocar un módulo de configuración en la raíz del proyecto:

# reloadium_config.py
FILE_TRACKER = ["*.py", "*.pyx"]
EXCLUSION_LIST = ["cache/*", "*.pyc", "test_*.py"]
PROFILE_FREQUENCY = 1000  # Hercios
AI_ASSIST_ENABLED = True
RELOAD_RECURSION_LIMIT = 3

Integración con IDE

Los usuarios de PyCharm pueden gestionar los ajustes directamente desde la interfaz del plugin instalado en el IDE.

Parámetros principales

Control de recarga en caliente

FILE_TRACKER define qué extensiones activan la recarga:

# Valor por defecto: ["*.py"]
FILE_TRACKER = ["*.py", "*.pyx", "*.jinja2", "*.html"]

EXCLUSION_LIST especifica rutas y archivos a ignorar:

# Valor por defecto: ["cache/*", "*.pyc"]
EXCLUSION_LIST = [
    "cache/*",
    "*.pyc",
    ".git/*",
    "venv/*",
    "node_modules/*",
    "*.log"
]

RELOAD_RECURSION_LIMIT regula la profundidad de recarga recursiva de módulos:

# Valor por defecto: 3
RELOAD_RECURSION_LIMIT = 5

Parámetros de profiling

PROFILE_FREQUENCY controla la tasa de muestreo del profiler:

# Valor por defecto: 1000 Hz
PROFILE_FREQUENCY = 5000  # Mayor precisión

PROFILE_TYPE selecciona el tipo de análisis:

# Opciones: "time", "memory", "both"
PROFILE_TYPE = "both"

MIN_TRACE_DURATION establece el umbral mínimo de tiempo para registrar una función:

# Valor por defecto: 0.001 (1ms)
MIN_TRACE_DURATION = 0.0001  # 100 microsegundos

Depuración con IA

AI_ASSIST_ENABLED activa o desactiva la depuración asistida por IA:

# Valor por defecto: True
AI_ASSIST_ENABLED = True

AI_CONTEXT_LINES define cuántas líneas de contexto se envían al modelo:

# Valor por defecto: 10
AI_CONTEXT_LINES = 20

Configuraciones específicas por framework

Proyectos Django

# reloadium_config.py - Django
FILE_TRACKER = ["*.py", "*.html", "*.jinja2", "*.js", "*.css"]
EXCLUSION_LIST = [
    "cache/*",
    "*.pyc",
    "migrations/*",
    "staticfiles/*",
    "media/*"
]
DJANGO_AUTO_REFRESH = True
DJANGO_TEMPLATE_REFRESH = True

Proyectos Flask

# reloadium_config.py - Flask
FILE_TRACKER = ["*.py", "*.html", "*.jinja2"]
EXCLUSION_LIST = [
    "cache/*",
    "*.pyc",
    "instance/*",
    ".venv/*"
]
FLASK_DEBUG_MODE = True
TEMPLATE_AUTO_REFRESH = True

Proyectos de ciencia de datos

# reloadium_config.py - Data Science
FILE_TRACKER = ["*.py", "*.ipynb"]
PROFILE_FREQUENCY = 10000
PROFILE_TYPE = "both"
NUMPY_PROFILE_ENABLED = True
PANDAS_PROFILE_ENABLED = True

Técnicas avanzadas

Recarga condicional

import os

if os.getenv("PRODUCTION_ENV"):
    HOT_RELOAD_ACTIVE = False
else:
    HOT_RELOAD_ACTIVE = True

Detector personalizado de cambios

def custom_change_handler(file_path, change_event):
    """Lógica personalizada para detectar cambios"""
    if file_path.endswith(".config.json"):
        return "full_reload"
    return "standard_reload"

CUSTOM_FILE_HANDLER = custom_change_handler

Filtro de profiling

def profiling_filter(func_name, module_name):
    """Determina si una función debe ser profileada"""
    if func_name.startswith("test_"):
        return False
    if module_name in ["logging", "os", "sys"]:
        return False
    return True

PROFILE_FILTER_FUNC = profiling_filter

Verificación y depuración de configuración

Validación de sintaxis

# Verificar sintaxis del archivo
python -m py_compile reloadium_config.py

# Confirmar carga del módulo
python -c "import reloadium; print(reloadium.__version__)"

Modo verbose

export RELOADIUM_DEBUG=1
reloadium run main.py

Jerarquía de configuración

El orden de precedencia es el siguiente:

1. Argumentos de línea de comandos
2. Variables de entorno
3. Archivo reloadium_config.py
4. Valores por defecto

Recomendaciones según entorno

Desarrollo

PROFILE_FREQUENCY = 1000
DETAILED_LOGGING = True
RELOAD_LATENCY = 0.1  # 100ms

Producción

PROFILE_FREQUENCY = 100
DETAILED_LOGGING = False
RELOAD_LATENCY = 1.0  # 1 segundo
SAFE_RELOAD_CHECK = True

Proyectos grandes

FILE_TRACKER = ["src/*.py", "app/*.py"]
EXCLUSION_LIST = ["tests/*", "docs/*", "examples/*"]
BATCH_CHANGES = True
MAX_PARALLEL_RELOADS = 2

Solución de problemas comunes

La configuración no se aplica: Verificar la ubicación del archivo, confirmar las variables de entorno, revisar errores de sintaxis y consultar los logs de Reloadium.

Datos de profiling imprecisso: Incrementar PROFILE_FREQUENCY, ajustar MIN_TRACE_DURATION y verificar conflictos con otros profilers activos.

Recargas excesivas: Aumentar RELOAD_LATENCY, ampliar EXCLUSION_LIST y activar BATCH_CHANGES.

Buenas prácticas

• Mantener configuraciones separadas por entorno (desarrollo, pruebas, producción)
• Comenzar con valores por defecto y ajustar gradualmente según necesidades
• Utilizar el profiler para medir el impacto de cada cambio de configuración
• Incluir el archivo de configuración en control de versiones para mantener consistencia en el equipo
• Revisar periódicamente la configuración a medida que el proyecto evoluciona