catalyst 0.0.1

The only dependency injection container for Dart you'll ever need

Catalyst

Catalyst is a dependency injection container for the dart language. It's fast, reliable and easy to understand.

Installation

Add the following to your pubspec.yaml:

dependencies:
  catalyst: ^0.0.1

Then run pub get

Usage

Importing

import 'package:catalyst/catalyst.dart';

Register Services

To register a service you have to call the register-method.

Container.register(String id, dynamic service, [List<dynamic> arguments])

Parameter	Description	Example
id	The unique id of the service	app.my_service
service	The service target	(int a) => a * 2
arguments	The arguments for the service. Entries with @-prefix are service references	[1, 'foo', bar]

Register a service with static arguments

Since not all services need an service injection, the arguments array also supports static entries.

Container container = new Container();

container.register('app.my_service', (String name) {
  return 'Hello $name';
}, ['Your Name']);

var knownServices = container.registeredServices; // Contains the registered Service 

Register a service with a service dependency

In most cases you need another registered service in your service. In that case you can pass the service name with a @-prefix to reference to it. The (sub-) dependencies are solved recursively.

Container container = new Container();

container.register('app.another_service', () {
  return {'name': 'Jane', 'age': '24'};
});

container.register('app.my_service', (dynamic anotherService) {
return "Name: ${anotherService['name']}, Age: ${anotherService['age']}";
}, ['@app.another_service']);

print(container.get('app.my_service')); // Outputs "Name: Jane, Age: 24"

Register a class as a service

You can also register a class as a service. If the service is loaded, the constructor gets called with the dependencies.

main() {
  Container container = new Container();

  // Register the first service
  container.register('namer', () => 'John Doe');

  // Register the second service. The constructor will be called with the passed arguments
  container.register('greeter', Greeter, ['@namer']);

  // Retrieve the greeter
  var greeter = container.get('greeter');

  // Greet
  print(greeter.greet()); // Outputs "Hello, my Name is John Doe!"
}

class Greeter {
  String name;

  Greeter(this.name) {}

  String greet() {
    return "Hello, my Name is $name!";
  }
}

Load a service

To load a service you have to call the get-method.
Once a service is loaded, it remains in memory at runtime. When the same service is loaded again, the first instance is returned.

Container::get(String id)

Parameter	Description	Example
id	The unique id of the service.	app.my_service

Container container = new Container();

// Register the first service
container.register('namer', () => 'Catalyst');

container.get('namer'); // returns "Catalyst"

Add Parameters

The service container also supports static parameters.
You can add a parameter using the addParameter-method

Container::addParameter(String name, dynamic value)

Parameter	Description	Example
name	The unique name of the parameter.	database.host
value	The parameter value	localhost

To pass a parameter to a service, add before and after the name a '%': %name.of.the.parameter%

Container container = new Container();
container.addParameter('database.host', 'localhost');

container.register('db.context', (String hostname) {
return 'Connecting to $hostname';
}, ['%database.host%']);

print(container.get('db.context')); // Outputs "Connecting to localhost"

Testing

$ pub run test

Contribute

Feel free to fork and add pull-requests 🤓

Todo

Implement auto wiring of services