Home

Awesome

Poodinis Dependency Injection Framework

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

DUB Package CI

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 or constructors.

Requires at least a D 2.086.1 compatible compiler
Uses the Phobos standard library

Features

See the TUTORIAL.md and examples for a complete walkthrough of all features.

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;

class Driver {}

interface Database {}

class RelationalDatabase : Database {
	private Driver driver;

	this(Driver driver) { // Automatically injected on creation by container
		this.driver = driver;
	}
}

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

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

	auto writer = dependencies.resolve!DataWriter;
}

Dependency set-up can further be reduced by enabling "Register on resolve". For more details and examples, see the examples directory.

Documentation

You can find the public API documentation here.

Alternatively you can generate documentation from the source code using DUB:

dub build --build=ddox

The documentation can then be found in docs/

History

For a full overview of changes, see CHANGES.md

Value Injectors

Poodinis doesn't come with implementations of value injectors. Value injectors are available in separate projects:

Have you made any or do you know of any? Please add them to this section via a pull request or open an issue.

Projects Using Poodinis

Future Work

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.