Inyección de dependencias,
cableada en tiempo de compilación.
Un constructor de contenedores de inyección de dependencias ligero y fácil de usar para Dart. Anota tus servicios con @Service y deja que build_runner genere el contenedor.
dart pub add catalyst_builder catalyst_builder_contracts import 'package:catalyst_builder/catalyst_builder.dart';
import 'main.catalyst_builder.plugin.g.dart';
@Service()
class ApiClient {
ApiClient(this.config);
final AppConfig config;
}
@GenerateServiceContainerPlugin(
pluginClassName: 'AppPlugin',
)
void main() {
final container = ServiceContainer()
..useAppPlugin()
..boot();
// Fully wired – no manual factories.
final api = container.resolve<ApiClient>();
}Tres pasos de la anotación a una app completamente cableada.
Marca tus servicios
Decora clases con @Service y tu punto de entrada con @GenerateServiceContainerPlugin.
@Service()
class UserRepository { … }Ejecuta build_runner
El constructor escribe un archivo *.catalyst_builder.plugin.g.dart junto a tu punto de entrada anotado.
$ dart run build_runner buildArranca el contenedor
Crea un ServiceContainer, registra el plugin generado, arráncalo – y resuelve lo que necesites.
container.useAppPlugin();
container.boot();Todo lo que necesitas. Nada que cablear a mano.
Construido alrededor de los principios SOLID y la inversión de dependencias – para que tu app siga siendo testeable mientras crece.
Generación en tiempo de compilación
El contenedor se genera con build_runner – sin reflexión en tiempo de ejecución, ideal para Flutter.
Basado en anotaciones
Declara servicios con @Service, o mapéalos de forma central con @ServiceMap.
Programa contra interfaces
Expón una implementación bajo su abstracción con exposeAs y cámbiala cuando quieras.
Arquitectura de plugins
Cada paquete puede incluir su propio plugin de contenedor generado – componlos en tu app raíz.
Funciona en todas partes
Dart y Flutter puros: Android, iOS, web, Windows, macOS y Linux.
Ligero y abierto
Huella mínima, puntos pub completos, licencia MIT – úsalo en cualquier proyecto, comercial o no.
Genera donde lo necesites. Depende de contratos en el resto de sitios.
Úsalo en tu paquete raíz o en un paquete plugin para generar el ServiceContainerPlugin.
Úsalo en paquetes que no generan un contenedor pero proporcionan servicios resolubles.
pub.dev/packages/catalyst_builder_contracts →Funcionando en menos de un minuto.
Añade los paquetes, anota tu punto de entrada, genera – listo. La documentación recorre una app Flutter completa.
$ dart pub add dev:build_runner \
catalyst_builder catalyst_builder_contractsimport 'package:catalyst_builder_contracts/catalyst_builder_contracts.dart';
@GenerateServiceContainerPlugin(pluginClassName: 'AppPlugin')
void main() { … }$ dart run build_runner buildfinal container = ServiceContainer();
container.useAppPlugin();
container.boot();
runApp(const MainApp()); Deja que el constructor cablee.
Tú escribes la app.
Gratis y de código abierto. Da estrella al repo, abre una issue o envía una pull request – las contribuciones son bienvenidas.