DepInC (Dependency Injection Core)

DepInC es un micro-framework experimental en Python basado en la arquitectura hexagonal (puertos y adaptadores), diseñado para facilitar el desarrollo desacoplado y modular de aplicaciones. Su núcleo está centrado en la inyección de dependencias y la capacidad de registrar dinámicamente servicios, casos de uso, adaptadores y modelos de dominio.

Nota: El ejemplo actual implementa un dominio ficticio de "vuelos" únicamente como prueba de concepto para validar la funcionalidad del framework. El objetivo real no es crear una app de vuelos, sino sentar las bases de un sistema extensible, tipo Laravel, con comandos artesanales que faciliten la creación de puertos, adaptadores y estructuras hexagonales.

Características

• Arquitectura Hexagonal real con separación de dominios, casos de uso y adaptadores.
• Contenedor de inyección de dependencias simple.
• Enrutamiento de comandos CLI como adaptador de entrada.
• Repositorio en memoria y dispatcher por consola como adaptadores de salida.
• Modelo de dominio fácilmente ampliable.
• Estructura preparada para comandos personalizados tipo artisan.

Estructura

.
├── adapters/               # Adaptadores de entrada (CLI) y salida (repositorio en memoria, dispatcher)
├── app/                    # Núcleo: modelos de dominio, puertos, casos de uso
├── commands/               # Comandos disponibles para el CLI
├── config/                 # Configuración general de la app
├── infrastructure/         # Contenedor y configuración de dependencias
├── stubs/                  # Plantillas de archivos
├── depinc.py               # Punto de entrada principal

Ejecuta de la app

python depinc.py run

Esto ejecuta el adaptador CLI con comandos de prueba para vuelos (crear y listar vuelos).

Comandos de ayuda

python depinc.py make

Este comando es una utilidad para crear archivos basicos que cumplen con la estructura recomendada. Es un maker interactivo que te permite personalizar la creacion de tus componentes, incluso te permite hacer una configuracion basica de los provider que puedes inyectar de forma automatica por el contenedor. Este maker nos permite creear:

• Modelos
• Casos de uso
• Adaptadores

Modelos

Todo modelo hereda de una clase base model.py el cual contiene la logica del control interno de estado. Se usan atributos internos y la modificacion de metodos magicos para controlar el estado del modelo. Esto permite:

• Conocer los atributos originales durante la creacion del modelo.
• Conocer los atributos que han sido modificados para optimizar las peticiones del repositorio.
• Mantiene un control interno de cuales son los atributos que seran almacenados por el repositorio (fillables).
• Marcar nuevos atributos, dinamicos o generados durante ejecucion, para ser almacenados.

Futuro del proyecto

• Soporte para mas comandos personalizados (depinc add adapter, etc).
• Capa ORM básica con soporte a múltiples drivers (mysql, sqlite, mongo).
• Sistema de eventos y observadores.
• Modularización avanzada para proyectos grandes.

Requisitos

• Python 3.12 o superior

Estado

Este proyecto se encuentra en fase experimental y está en desarrollo activo. Cualquier contribución o sugerencia es bienvenida.

Licencia

Este proyecto está licenciado bajo la Creative Commons Atribución 4.0 Internacional (CC BY 4.0). Puedes compartir y modificar libremente este código, siempre y cuando menciones al autor original.