L'injection de dépendances,
câblée à la compilation.
Un builder de conteneur d'injection de dépendances léger et simple d'emploi pour Dart. Annotez vos services avec @Service et laissez build_runner générer le conteneur.
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>();
}Trois étapes, de l'annotation à une app entièrement câblée.
Marquez vos services
Décorez vos classes avec @Service et votre point d'entrée avec @GenerateServiceContainerPlugin.
@Service()
class UserRepository { … }Exécutez build_runner
Le builder écrit un fichier *.catalyst_builder.plugin.g.dart à côté de votre point d'entrée annoté.
$ dart run build_runner buildDémarrez le conteneur
Créez un ServiceContainer, enregistrez le plugin généré, démarrez-le – puis résolvez tout ce que vous voulez.
container.useAppPlugin();
container.boot();Tout ce qu'il faut. Rien à câbler à la main.
Conçu autour des principes SOLID et de l'inversion de dépendance – pour garder votre app testable avec la croissance.
Génération à la compilation
Le conteneur est généré avec build_runner – aucune réflexion à l'exécution, parfait pour Flutter.
Piloté par annotations
Déclarez vos services avec @Service, ou centralisez-les avec @ServiceMap.
Programmez contre des interfaces
Exposez une implémentation sous son abstraction avec exposeAs et échangez-la à tout moment.
Architecture à plugins
Chaque paquet peut fournir son propre plugin de conteneur généré – composez-les dans votre app racine.
Fonctionne partout
Dart et Flutter purs : Android, iOS, web, Windows, macOS et Linux.
Léger et ouvert
Empreinte réduite, points pub complets, licence MIT – utilisez-le dans tout projet, commercial ou non.
Générez où c'est nécessaire. Dépendez des contrats partout ailleurs.
Utilisez-le dans votre paquet racine ou un paquet plugin pour générer le ServiceContainerPlugin.
Utilisez-le dans les paquets qui ne génèrent pas de conteneur mais fournissent des services résolubles.
pub.dev/packages/catalyst_builder_contracts →Opérationnel en moins d'une minute.
Ajoutez les paquets, annotez votre point d'entrée, générez – c'est fait. La documentation détaille une app Flutter complète.
$ 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()); Laissez le builder câbler.
Vous écrivez l'app.
Gratuit et open source. Mettez une étoile au repo, ouvrez une issue ou envoyez une pull request – les contributions sont les bienvenues.