auto_injector 0.0.1-alpha.2

Automatic Dependency Injection System, but without build_runner :)

Auto Injector

Dependency injection system. But without build_runner :)

IMPORTANT!

This package is still under development. Not recommended for use in production!

Example

void main(){

    final autoInjector = AutoInjector();

    // factory
    autoInjector.add(Controller.new);

    // lazySingleton
    autoInjector.addLazySingleton(Repository.new);

    // Singleton
    autoInjector.addSingleton(Datasource.new);

    // instance
    autoInjector.instance('Instance');

    // Inform that you have finished adding instances
    autoInjector.commit();

    // fetch
    final controller = autoInjector.get<Controller>();
    print(controller); // Instance of 'Controller'.

    // or use calleble function (withless .get())
    final datasource = autoInjector<Datasource>();
    print(datasource); // Instance of 'Datasource'.

}


class Controller {
    final Repository repository;

    Controller(this.repository)
}

class Repository {
    final Datasource datasource;

    Repository({required this.datasource})
}

class Datasource {}

Dispose Singleton

Singletons can be terminated on request using the disposeSingleton method returning the instance for executing the dispose routine.

final deadInstance = autoInjector.disposeSingleton<MyController>();
deadInstance.close();

Modularization

For projects with multiple scopes, try uniting the instances by naming them Module or Container. With this, you can register specific instances for each module.

// app_module.dart
final appModule = AutoInjector(
  tag: 'AppModule',
  on: (i) {
    i.addInjector(productModule);
    i.addInjector(userModule);
    i.commit();
  },
);

...

// product_module.dart
final productModule = AutoInjector(
  tag: 'ProductModule',
  on: (i) {
    i.addInstance(1);
  },
);

...

// user_module.dart
final userModule = AutoInjector(
  tag: 'UserModule',
  on: (i) {
    i.addInstance(true);
  },
);

...

void main() {
  print(appModule.get<int>());
  print(appModule.get<bool>());
}

Também é possível remover todos os singletons de uma tag específica usando o método disposeSingletonsByTag que informa cada instância removida atraves de uma função anônima:

autoInjector.disposeSingletonsByTag('ProductModule', (instance){
  // individual dispose routine
});

Param Transform

Existe a possíbilidade de escutar e transformar todos os paramentros que estão sendo analisados quando há o pedido da instancia (AutoInject.get()). Adicione transformadores na instância principal.

final homeModule = AutoInjector(
  paramTransforms: [
    (param) {
    if(param is NamedParam){
        return param;
    } else if(param is PositionalParam) {
        return param;
    } else {
        return param;
    }
  ],
);