---

boost-ext.di

Your C++14 one header only Dependency Injection library with no dependencies

https://www.youtube.com/watch?v=yVogS4NbL6U

---

Quick start

Download

boost-ext.di requires only one file. Get the latest header here!

Include

#include<boost/di.hpp>namespacedi= boost::di;

Compile

• GCC/Clang

  $CXX -std=c++14 -O2 -fno-exceptions -fno-rtti -Wall -Werror -pedantic-errors file.cpp

• MSVC

  cl /std:c++14 /Ox /W3 file.cpp

Quick guide - Create object graph

classctor {
public:explicitctor(int i) : i(i) {}
int i;
};
structaggregate {
double d;
};
classexample {
public:example(aggregate a, const ctor& c) {
assert(87.0 == a.d);
assert(42 == c.i);
};
};
intmain() {
constauto injector = di::make_injector(
di::bind<int>.to(42),
di::bind<double>.to(87.0)
);
injector.create<example>();
}

Run this example on Wandbox.

	Clang-3.8	GCC-6	MSVC-2015
Compilation Time	0.102s	0.118s	0.296s
Binary size (stripped)	6.2kb	6.2kb	105kb
ASM x86-64	xor eax, eax retq

Quick guide - Bind interfaces

structinterface {
virtual~interface() noexcept = default;
virtualintget() const = 0;
};
classimplementation : publicinterface {
public:intget() constoverride { return42; }
};
structexample {
example(std::shared_ptr<interface> i) {
assert(42 == i->get());
}
};
intmain() {
constauto injector = di::make_injector(
di::bind<interface>.to<implementation>()
);
injector.create<std::unique_ptr<example>>();
}

Run this example on Wandbox.

	Clang-3.8	GCC-6	MSVC-2015
Compilation Time	0.102s	0.118s	0.296s
Binary size (stripped)	6.2kb	6.2kb	105kb
ASM x86-64 (same as `make_unique`)	push %rbx mov %rdi,%rbx mov $0x8,%edi callq 0x4008e0 <_Znwm@plt> movq $0x400c78,(%rax) mov %rax,(%rbx) mov %rbx,%rax pop %rbx retq

Quick guide - Bind templates

template<classErrorPolicy = classTErrorPolicy>
classsimple_updater {
public:voidupdate() const {
ErrorPolicy::on("update");
}
};
template<classUpdater = classTUpdater>
classexample {
public:explicitexample(const Updater& updater)
: updater(updater)
{ }
voidupdate() {
updater.update();
}
private:const Updater& updater;
};
intmain() {
structthrow_policy {
staticvoidon(const std::string& str) {
throwstd::runtime_error(str);
}
};
constauto injector = di::make_injector(
di::bind<classTErrorPolicy>.to<throw_policy>(),
di::bind<classTUpdater>.to<simple_updater>()
);
injector.create<example>().update();
// Terminates with an uncaught exception because of our bound error policy
}

Run this example on Wandbox.

	Clang-3.8	GCC-6	MSVC-2015
Compilation Time	0.102s	0.118s	0.296s
Binary size (stripped)	6.2kb	6.2kb	105kb
ASM x86-64	xor eax, eax retq

Quick guide - Bind concepts

structStreamable {
template<classT>
autorequires(T&& t) -> decltype(
int( t.read() ),
t.write(int)
);
};
template<classExchange = Streamable(classExchangeStream)
class Engine = Streamable(classEngineStream)>
class example {
public:example(Exchange exchange, Engine engine)
: exchange(std::move(exchange)), engine(std::move(engine))
{ }
private:
Exchange exchange;
Engine engine;
};
intmain() {
constauto injector = di::make_injector(
di::bind<Streamable(classExchangeStream)>.to<exchange>(),
di::bind<Streamable(classEngineStream)>.to<engine>()
);
injector.create<example>();
}

Run this example on Wandbox.

	Clang-3.8	GCC-6	MSVC-2015
Compilation Time	0.102s	0.118s	0.296s
Binary size (stripped)	6.2kb	6.2kb	105kb
ASM x86-64	xor eax, eax retq

---

Documentation

• Introduction
  • Do I use a Dependency Injection already?
  • Do I use Dependency Injection correctly?
  • Do I need a Dependency Injection?
  • STUPID vs SOLID - "Clean Code" Uncle Bob
  • Do I need a DI Framework/Library?
  • Manual DI - Wiring Mess (Avoid it by using [Boost].DI)
  • Real Life examples?
  • Why [Boost].DI?
  • [Boost].DI design goals
  • Articles
  • Videos
  • [Boost::ext].DI
  • Dependency Injection In General
  • Acknowledgements
• Overview
  • Quick Start
  • Dependencies
  • Supported/Tested compilers
  • Configuration
  • Exception Safety
  • Thread Safety
  • Error Messages
  • Performance
• Tutorial
  • 0. [Pre] Refactor towards DI
  • 1. [Basic] Create objects tree
  • 2. [Basic] First steps with bindings
  • 3. [Basic] Decide the life times
  • 4. [Basic] Annotations to the rescue
  • 5. [Basic] Split your configuration
  • 6. [Advanced] Dump/Limit your types
  • 7. [Advanced] Customize it
  • 8. [Advanced] Extend it
• Try It Online!
• Benchmarks
  • Performance
  • C++ Libraries
  • C++ vs Java vs CLibraries
  • Usage of C++ vs Java vs CLibraries
• User Guide
  • Injector
  • Bindings
  • Injections
  • Annotations
  • Scopes
  • Modules
  • Providers
  • Policies
  • Concepts
  • Configuration
• Examples
  • Hello World
  • Bindings
  • Dynamic Bindings
  • Forward Bindings
  • Is Creatable
  • Multiple Bindings
  • Binding Non-owning Pointer
  • Binding Templates
  • Binding To Constructor
  • Automatic Injection
  • Constructor Signature
  • Constructor Injection
  • Multiple Interface
  • Annotations
  • Deduce Scope
  • Custom Scope
  • Eager Singletons
  • Modules
  • Modules (hpp/cpp)
  • Custom Policy
  • Custom Provider
  • Pool Provider
  • Configuration
  • Polymorphism
  • Inheritance
  • Type Erasure
  • Function
  • Variant
  • Templates
  • Concepts
• Extensions
  • Injector
  • Constructor Bindings
  • Contextual Bindings
  • Assisted Injection
  • Extensible Injector
  • Concepts
  • Factory
  • Shared Factory
  • Lazy
  • Named Parameters
  • XML Injection
  • Serialize
  • Types Dumper
  • UML Dumper
  • Heap Provider
  • Mocks Provider
  • Runtime Provider
  • Scoped Scope
  • Session Scope
  • Shared Scope
• FAQ
• CHANGELOG
  • [1.3.0] - 2023-05-23
  • [1.2.0] - 2020-07-21
  • [1.1.0] - 2019-01-07
  • [1.0.2] - 2018-01-04
  • [1.0.1] - 2016-05-04
  • [1.0.0] - 2016-02-22
  • [0.5.0] - 2015-01-12
  • [0.1.0] - 2014-08-15

---

Disclaimerboost-ext.di is not an official Boost library.