Dependency injection,
cablata in fase di build.
Un builder di container per dependency injection leggero e semplice da usare per Dart. Annota i tuoi servizi con @Service e lascia che build_runner generi il container.
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>();
}Tre passi dall'annotazione a un'app completamente cablata.
Contrassegna i tuoi servizi
Decora le classi con @Service e il tuo entry point con @GenerateServiceContainerPlugin.
@Service()
class UserRepository { … }Esegui build_runner
Il builder scrive un file *.catalyst_builder.plugin.g.dart accanto al tuo entry point annotato.
$ dart run build_runner buildAvvia il container
Crea un ServiceContainer, registra il plugin generato, avvialo – poi risolvi qualsiasi cosa.
container.useAppPlugin();
container.boot();Tutto il necessario. Nulla da cablare a mano.
Costruito attorno ai principi SOLID e all'inversione delle dipendenze – così la tua app resta testabile mentre cresce.
Generazione a compile time
Il container è generato con build_runner – nessuna reflection a runtime, perfetto per Flutter.
Basato su annotazioni
Dichiara i servizi con @Service, oppure mappali centralmente con @ServiceMap.
Programma contro interfacce
Espone un'implementazione sotto la sua astrazione con exposeAs e scambiala quando vuoi.
Architettura a plugin
Ogni pacchetto può fornire il proprio plugin di container generato – componili nella tua app radice.
Funziona ovunque
Dart e Flutter puri: Android, iOS, web, Windows, macOS e Linux.
Leggero e aperto
Ingombro ridotto, punti pub completi, licenza MIT – usalo in qualsiasi progetto, commerciale o meno.
Genera dove ti serve. Dipendi dai contratti ovunque altro.
Usalo nel pacchetto radice o in un pacchetto plugin per generare lo ServiceContainerPlugin.
Usalo nei pacchetti che non generano un container ma forniscono servizi risolvibili.
pub.dev/packages/catalyst_builder_contracts →Pronto in meno di un minuto.
Aggiungi i pacchetti, annota l'entry point, genera – fatto. La documentazione guida un'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()); Lascia cablare al builder.
Tu scrivi l'app.
Gratuito e open source. Metti una stella al repo, apri una issue o invia una pull request – i contributi sono benvenuti.