Skip to main content

PyPI PyPI - Python Version PyPI - License PyPI - Downloads codecov

PyDIO

Lightweight and functional dependency injection library for Python.

Name

PyDIO (stylized as PyDIO, installable as pydio, pronounced "pie-dee-o") stands for Python dependency injection library.

About

PyDIO aims to be simple, yet still powerful, allowing you to feed dependencies inside your application in a flexible way. PyDIO design is based on simple assumption that dependency injection can be achieved using a straightforward key-to-function mapping, where key specifies type of object you want to inject and function is a factory function that creates instances of that type.

In PyDIO, this is implemented using providers and injectors. You use providers to configure your key-to-function mapping, and then you use injectors to perform a lookup of a specific key and creation of the final object.

Here's a simple example:

import abc

from pydio.api import Provider, Injector

provider = Provider()

@provider.provides('greet')
def make_greet():
    return 'Hello, world!'

def main():
    injector = Injector(provider)
    greet_message = injector.inject('greet')
    print(greet_message)

if __name__ == '__main__':
    main()

Now you can save the snippet from above as example.py file and execute to see the output:

$ python example.py
Hello, world!

Key features

  • Support for any hashable keys: class objects, strings, ints etc.
  • Support for any type of object factories: function, coroutine, generator, asynchronous generator.
  • Automatic resource management via generator-based factories (similar to pytest's fixtures)
  • Multiple environment support: testing, development, production etc.
  • Limiting created object's lifetime to user-defined scopes: global, application, use-case etc.
  • No singletons used, so there is no global state...
  • ...but you still can create global injector on your own if you need it :-)

Installation

You can install PyDIO using one of following methods:

  1. From PyPI (for stable releases):

    $ pip install pydio
    
  2. Directly from source code repository (for all releases):

    $ pip install git+https://github.com/mwiatrzyk/pydio.git@[branch-or-tag]
    

In addition to standard pip tool, you can also install it using uv, poetry or other alternative.

Documentation

You have two options available:

  1. Visit PyDIO's ReadTheDocs site.

  2. Take a tour around functional tests.

News

PyDIO 1.x is coming...

Since version 0.5.2 there is a pydio.v1 backport module available containing candidate version of the upcoming 1.x PyDIO release. It is a result of library refactoring with several improvements and few useful features added which are a result of intensive use of this library in various projects. Some of these changes include:

  • Use of typing.Protocol instead of abc.ABC for interfaces

  • Explicit async and non-async support via pydio.v1.injectors.AsyncInjector and pydio.v1.injectors.Injector classes.

  • Support for typing.Annotated for custom variants of types (f.e. Annotated[int, 'tcp.port'])

  • Automatic injections via type hints:

    from pydio.v1.api import Provider, provides
    
    provider = Provider()
    
    @provides(provider, AbstractSomething, mode="auto")
    def build_something(foo: AbstractFoo, bar: AbstractBar):
        return Something(foo, bar)  # No manual injection needed
    
  • Better scoping support via namespaces, not just plain string:

    Provider part:

    from pydio.v1.api import Provider, provides
    
    provider = Provider()
    
    @provides(provider, AbstractSomething, scope=("parent", "child"), mode="auto")
    def build_something(foo: AbstractFoo, bar: AbstractBar):
        return Something(foo, bar)  # No manual injection needed
    

    Injection part:

    from pydio.v1.api import Injector
    
    injector = Injector(provider)
    
    with injector.scoped("parent") as parent:
        with parent.scoped("child") as child:
            something = child.inject(AbstractSomething)
    
  • Better type hinting support.

Visit v1 API documentation to read more.

Disclaimer

PyDIO is an independent open-source project in the Python ecosystem. It is not affiliated with, sponsored by, or endorsed by any company, organization, or product of the same or similar name. Any similarity in names is purely coincidental and does not imply any association.

License

This project is released under the terms of the MIT license.

See LICENSE.txt for more details.

Author

Maciej Wiatrzyk maciej.wiatrzyk@gmail.com

Metadata

Release files for PyDIO 0.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for PyDIO 0.5.3
File Size Uploaded Provenance Actions
pydio-0.5.3.tar.gz 152.7 kB Without provenance Details for pydio-0.5.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for PyDIO 0.5.3
File Interpreter ABI Platform Actions
pydio-0.5.3-py3-none-any.whl Python 3 none any Details for pydio-0.5.3-py3-none-any.whl

Total release size: 193.4 kB

Release files / pydio-0.5.3.tar.gz

Download URL pydio-0.5.3.tar.gz
Size 152.7 kB
Tags Source
SHA-256 checksum
How to use checksums
431e4c97968c51058f2523298037ac7ff19c45547a8e78ba0c0172895398afa8
BLAKE2b-256 checksum
How to use checksums
9bce653ab12cda52d10af569173807698645042fc360c9b1150c891ecc5d7a01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Release files / pydio-0.5.3-py3-none-any.whl

Download URL pydio-0.5.3-py3-none-any.whl
Size 40.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aa8dfe38bcbca5ac9c6e1a39c5eaebb412d6c5d5abee912e30143a5090032c1c
BLAKE2b-256 checksum
How to use checksums
df5933e542692d5cd345d237b15f9646cd3e03a3e3d377e1bb6dccc780089090
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Security for PyDIO 0.5.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.3 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page