A dependency injection tool for python
Project description
Pypendency
Pypendency is a dependency injection library for python >=3.7.
Installation
pip install pypendency
Usage
Pypendency supports:
- Declaration of explicit dependencies for each registered service.
- Lazy evaluation (dependencies are not evaluated and instantiated until they are required)
- Loading dependencies from different sources, such as python file, yaml file or directories. Also, it can be done programmatically.
Examples
# application_bootstrap.py
from pypendency.builder import container_builder
from pypendency.definition import Definition
from pypendency.loaders.yaml_loader import YamlLoader
from pypendency.loaders.py_loader import PyLoader
# Manually
container_builder.set('random_object', object())
container_builder.set_definition(
Definition('another_random_object', 'builtins.object')
)
# File by file
YamlLoader(container_builder).load('/absolute/path/to/yaml/example.yaml')
PyLoader(container_builder).load('/absolute/path/to/python_file/example.py')
PyLoader(container_builder).load_by_module_name('python_file.example')
# Specifying a directory
YamlLoader(container_builder).load_dir('/absolute/path/to/yaml/')
PyLoader(container_builder).load_dir('/absolute/path/to/python_file/')
# path_to_yaml/example_di.yaml
example_class_identifier:
fqn: example.class.namespace.ClassName
args:
- '@another_example_class_identifier'
kwargs:
example_kwarg: '@random_object'
# python/file/namespace/example_di.py
from pypendency.argument import Argument
from pypendency.builder import ContainerBuilder
from pypendency.definition import Definition
def load(container_builder: ContainerBuilder):
container_builder.set("literal_string", "example_literal_string")
container_builder.set_definition(
Definition(
"another_example_class_identifier",
"another.example.class.namespace.AnotherClassName",
[
Argument.no_kw_argument("@literal_string"),
Argument("kw_arg_example", "@literal_string"),
]
)
)
Running tests
Build the docker image:
docker build . -t pypendency-dev
Run tests:
docker run -v $(pwd)/.:/usr/src/app pypendency-dev bash -c "pipenv run make run-tests"
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pypendency-0.4.0.tar.gz
(6.5 kB
view hashes)
Built Distribution
pypendency-0.4.0-py3-none-any.whl
(10.1 kB
view hashes)
Close
Hashes for pypendency-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5e3f0ce80704f9690658c2c7b6328a70057bdd185060808ec0736ba66a37c3f8 |
|
MD5 | 7619fb6f0a67e9f0343a12926d652820 |
|
BLAKE2b-256 | da798bb870171faad91278de8996df46be8c561ae2dae8489b438fb50ca34519 |