v6.2.1 Dart & Flutter · licencia MIT

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
lib/main.dart
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>();
}
6.2.1 Última versión
150/160 Puntos pub
6 Plataformas compatibles
MIT Licencia de código abierto
✓ Editor verificado
CÓMO FUNCIONA

Tres pasos de la anotación a una app completamente cableada.

1 annotate

Marca tus servicios

Decora clases con @Service y tu punto de entrada con @GenerateServiceContainerPlugin.

@Service()
class UserRepository { … }
2 generate

Ejecuta build_runner

El constructor escribe un archivo *.catalyst_builder.plugin.g.dart junto a tu punto de entrada anotado.

$ dart run build_runner build
3 boot

Arranca el contenedor

Crea un ServiceContainer, registra el plugin generado, arráncalo – y resuelve lo que necesites.

container.useAppPlugin();
container.boot();
CARACTERÍSTICAS

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.

DOS PAQUETES

Genera donde lo necesites. Depende de contratos en el resto de sitios.

catalyst_builder Builder

Úsalo en tu paquete raíz o en un paquete plugin para generar el ServiceContainerPlugin.

pub.dev/packages/catalyst_builder →
catalyst_builder_contracts Contracts

Úsalo en paquetes que no generan un contenedor pero proporcionan servicios resolubles.

pub.dev/packages/catalyst_builder_contracts →
INICIO RÁPIDO

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.

1 · Instalación
$ dart pub add dev:build_runner \
    catalyst_builder catalyst_builder_contracts
2 · Anota lib/main.dart
import 'package:catalyst_builder_contracts/catalyst_builder_contracts.dart';

@GenerateServiceContainerPlugin(pluginClassName: 'AppPlugin')
void main() { … }
3 · Generar y arrancar
$ dart run build_runner build
final 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.