-
Notifications
You must be signed in to change notification settings - Fork 40
Home
Welcome to our documentation!
Kangaru is an inversion of control container for C++11 and later. We support features like operation between containers, injection via function parameter, automatic call of member function on instance creation and much more!
Our goal is to create a container capable of automatic, recusive dependency injection that do most diagnostics at compile time, while keeping the simplest interface possible, and all that without being intrusive into user/library code.
Kangaru is a header only library because of it's extensive use of templates. The name kangaru comes from the container's feature to inject itself into a service as a dependency, and because kangaroos are awesome.
Indeed, the container does not impose a way to construct, contain or inject your classes. You are in full control of everything related to the classes of your project.
Control over memory allocation in containers is not yet supported, but is planned: #41. We do use std::unordered_map and std::vector with the default allocators.
To make kangaru available on your machine, you must clone the repository and create a build directory:
$ git clone https://github.com/gracicot/kangaru.git && cd kangaru
$ mkdir build && cd build
Then use cmake to generate the makefile and export the package informations:
$ cmake ..
Tou can then use cmake to find the package and add include paths:
find_package(kangaru REQUIRED)
target_link_libraries(<YOUR TARGET> PUBLIC kangaru)
Then, you can simply include the library:
#include <kangaru/kangaru.hpp>
Take note that you will need to add the library to your include paths.
All declarations are made in the namespace kgr. Additionnaly, the namespace kgr contains the namespace detail, which itself contains implementation details.
Note that the detail namespace is not considered as a part of the API and its content might be subject to changes.
In this documentation, many classes will be refered as services or service definitions.
Services are classes that are either injected by the container or have other classes as dependencies.
Service Definitions are classes that contain a service and tell the container how this particular service should behave within the container.
This library does not make use of macros to prevent multiple inclusion.
Every macros that starts with KGR_KANGARU_ is considered reserved.
Note that some features of this library are easier to use with macros, and we recommend you to use those that are defined in the documentation.
Macros defined by the library are not part of it's interface.
- MSVC: 2015 update 3 or better
- GCC: 5.4 or better
- Clang: 3.6 or better
Since many breaking changes has been introduced in v4.0.0, we decided to write a migration guide from the 3.x.y series to v4.0.0.
We also added a compatibility header to make the transition smoother between the two versions.