poodinis 6.3.0

A dependency injection framework with support for autowiring.


To use this package, put the following dependency into your project's dependencies section:

dub.json
dub.sdl

Poodinis Dependency Injection Framework

Version 6.3.0 Copyright 2014-2016 Mike Bierlee Licensed under the terms of the MIT license - See LICENSE.txt

Master: Build Status - Dev: Build Status

Poodinis is a dependency injection framework for the D programming language. It is inspired by the [Spring Framework] and [Hypodermic] IoC container for C++. Poodinis supports registering and resolving classes either by concrete type or interface. Automatic injection of dependencies is supported through the use of UDAs (Referred to as autowiring).

Requires at least a D 2.068.0 compatible compiler Uses the Phobos standard library Can be built with DUB 0.9.24 or higher

History

For a full overview of changes, see CHANGES.md

Getting started

###DUB Dependency See the Poodinis [DUB project page] for instructions on how to include Poodinis into your project.

###Quickstart The following example shows the typical usage of Poodinis:

import poodinis;

interface Database{};
class RelationalDatabase : Database {}

class DataWriter {
	@Autowire
	private Database database; // Automatically injected when class is resolved
}

void main() {
	auto dependencies = DependencyContainer.getInstance();
	dependencies.register!DataWriter;
	dependencies.register!(Database, RelationalDatabase);

	auto writer = dependencies.resolve!DataWriter;
}

For more examples, see the examples directory.

###Tutorial For an extended tutorial walking you through all functionality offered by Poodinis, see TUTORIAL.md

Documentation

You can generate Public API documentation from the source code using DUB:

dub build --build=ddox

The documentation can then be found in docs/

Future Work

  • Component scan (auto-registration)
  • Phobos collections autowiring
  • Constructor injection
  • Named qualifiers
  • Value type injection

Contributing

Any and all pull requests are welcome! If you (only) want discuss changes before making them, feel free to open an Issue on github. Please develop your changes on (a branch based on) the develop branch. Continuous integration is preferred so feature branches are not neccessary.

Authors:
Mike Bierlee
Dependencies:
none
Versions:
8.0.1 2017-Aug-13
8.0.0 2016-Dec-26
7.0.1 2016-Sep-05
7.0.0 2016-Sep-03
6.3.0 2016-Jun-27
Show all 25 versions
Download Stats:
  • 56 downloads today

  • 149 downloads this week

  • 558 downloads this month

  • 4212 downloads total