pyjection 1.0.0

Implicit class bindings

When no id is specified in the register method Pyjection creates implicit bindings for classes. The implicit bindings assume your code follows PEP8 conventions: your classes are named in CamelCase, and your args are named in lower_with_underscores. Pinject transforms class names to injectable arg names by lowercasing words and connecting them with underscores.

Explicit class bindings

It is also possible to manually set the id of a class when during its registration by specifying it as a second arguments.

container.register(FooClass, "inner_class")

With the example above, FooClass will later be injected to arguments named inner_class

Simple argument specification

Sometimes the argument we need to inject is not an instance of a class. The register and register_singleton methods return a service object that lets us specify what we want to bind to a given argument by using the add_argument method.

from pyjection.dependency_injector import DependencyInjector

class FooClass(object):

    def __init__(self, foo):
        self.foo = foo

container = DependencyInjector()
service = container.register(FooClass)
service.add_argument("foo", "bar")

foo_class = container.get("foo_class")
print(foo_class.foo) # Will print bar

Reference argument specification

A service argument can also reference another dependency injector service. It is useful when we want to inject a class not matching the argument name.

from pyjection.dependency_injector import DependencyInjector
from pyjection.reference import Reference

class OuterClass(object):

    def __init__(self, inner_class):
        self.inner_class = inner_class

class FooClass(object):

    def __init__(self):
        self.foo = "bar"

container = DependencyInjector()
container.register(FooClass)
container.register(OuterClass).add_argument("inner_class", Reference('foo_class'))

instance = container.get(OuterClass)
print(instance.inner_class.foo) # Will print bar