Manual configuration

WireUp provides convenient decorators and functions for you to use and perform dependency injection. If using decorators or functions such as wire not appropriate for your application then manual container configuration is also possible.

Using wireup without registration decorators

In addition to using @container.register to register each dependency, automatic registration is also possible by using the container.regiter_all_in_module(module, pattern = "*") method.

Module represents the top level module containing all your dependencies, optionally a fnmatch pattern can be specified to only register classes that match the pattern. This is the equivalent of using @container.register on each.

container.register_all_in_module(app.service, "*Service")

Interfaces

Even though It's not possible to automatically register abstract types and implementation using qualifiers. Manual registration is still possible.

container.abstract(FooBase)
container.register(FooBar, qualifier="bar")
container.register(FooBaz, qualifier="baz")

Manually wiring parameters

Given that parameters can't be resolved from type annotations alone, the container.wire method offers two shortcuts for parameter injection: wire(name="") and wire(expr="").

To achieve the same outcome without relying on default values, you can use the container's initialization context. This allows you to manually provide data that the library would otherwise gather from the decorators.

container.register_all_in_module(app.services, "*Service")

# Register parameters individually using add_param
container.initialization_context.add_param(
    klass=DbService,
    argument_name="connection_str",
    parameter_ref="connection_str",
)
container.initialization_context.add_param(
    klass=DbService,
    argument_name="connection_str",
    parameter_ref=TemplatedString("${cache_dir}/${auth_user}/db"),
)

# Alternatively, you can update the context in bulk using a dictionary.
# When using interpolated strings, make sure you wrap the string with TemplatedString.
container.initialization_context.update(
    DbService,
    {
        "connection_str": "connection_str",
        "cache_dir": TemplatedString("${cache_dir}/${USER}/db"),
    },
)

Configuration can also be stored in JSON or YAML documents that can be read and used to update the container accordingly.