v6.2.1 Dart & Flutter · sous licence MIT

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
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 Dernière version
150/160 Points pub
6 Plateformes prises en charge
MIT Licence open source
✓ Éditeur vérifié
COMMENT ÇA MARCHE

Trois étapes, de l'annotation à une app entièrement câblée.

1 annotate

Marquez vos services

Décorez vos classes avec @Service et votre point d'entrée avec @GenerateServiceContainerPlugin.

@Service()
class UserRepository { … }
2 generate

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 build
3 boot

Dé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();
FONCTIONNALITÉS

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.

DEUX PAQUETS

Générez où c'est nécessaire. Dépendez des contrats partout ailleurs.

catalyst_builder Builder

Utilisez-le dans votre paquet racine ou un paquet plugin pour générer le ServiceContainerPlugin.

pub.dev/packages/catalyst_builder →
catalyst_builder_contracts Contracts

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 →
DÉMARRAGE RAPIDE

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.

1 · Installation
$ dart pub add dev:build_runner \
    catalyst_builder catalyst_builder_contracts
2 · Annoter lib/main.dart
import 'package:catalyst_builder_contracts/catalyst_builder_contracts.dart';

@GenerateServiceContainerPlugin(pluginClassName: 'AppPlugin')
void main() { … }
3 · Générer & démarrer
$ dart run build_runner build
final 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.