PyDIO 0.5.0__tar.gz

pydio-0.5.0/.bumpify.toml

@@ -0,0 +1,27 @@
+[vcs]
+type = "git"
+
+[semver]
+version = "0.0.1"
+bump_commit_message_template = "bump: {prev_version_str} -> {version_str} [skip ci]"
+version_tag_name_template = "v{version_str}"
+
+[[semver.bump_rules]]
+branch = "master"
+when_breaking = "minor"
+when_feat = "minor"
+when_fix = "patch"
+
+[[semver.version_files]]
+path = "pyproject.toml"
+prefix = "version"
+encoding = "utf-8"
+
+[[semver.version_files]]
+path = "pydio/__init__.py"
+prefix = "__version__"
+encoding = "utf-8"
+
+[[semver.changelog_files]]
+path = "CHANGELOG.md"
+encoding = "utf-8"

pydio-0.5.0/.circleci/config.yml

@@ -0,0 +1,136 @@
+version: 2.1
+
+commands:
+  install-deps:
+    parameters:
+      ver_major:
+        type: integer
+      ver_minor:
+        type: integer
+    steps:
+      - restore_cache:
+          name: restore dependency cache
+          keys:
+            - py<<parameters.ver_major>><<parameters.ver_minor>>-{{ checksum "uv.lock" }}
+      - run: uv python pin <<parameters.ver_major>>.<<parameters.ver_minor>>
+      - run: uv sync
+      - save_cache:
+          name: save dependency cache
+          key: py<<parameters.ver_major>><<parameters.ver_minor>>-{{ checksum "uv.lock" }}
+          paths:
+            - .venv
+  configure-git:
+    steps:
+      - run: git config user.name "CircleCI"
+      - run: git config user.email "noreply@circleci.com"
+  push-to-git:
+    steps:
+      - run: git push --set-upstream origin $CIRCLE_BRANCH
+      - run: git push --tags
+  publish-coverage:
+    steps:
+      - run: uv run inv check-coverage -f0
+      - run: curl -Os https://uploader.codecov.io/latest/linux/codecov
+      - run: chmod +x codecov
+      - run: ./codecov
+
+jobs:
+  test:
+    docker:
+      - image: cimg/python:<<parameters.ver_major>>.<<parameters.ver_minor>>
+    parameters:
+      ver_minor:
+        type: integer
+      ver_major:
+        type: integer
+    steps:
+      - checkout
+      - install-deps:
+          ver_major: <<parameters.ver_major>>
+          ver_minor: <<parameters.ver_minor>>
+      - run: uv run inv check
+  publish-coverage:
+    docker:
+      - image: cimg/python:3.9
+    steps:
+      - checkout
+      - configure-git
+      - install-deps:
+          ver_major: 3
+          ver_minor: 9
+      - publish-coverage
+  tag:
+    docker:
+      - image: cimg/python:3.9
+    steps:
+      - checkout
+      - configure-git
+      - install-deps:
+          ver_major: 3
+          ver_minor: 9
+      - run: uv tool install --python 3.9 bumpify
+      - run: bumpify --dry-run bump
+      - run: bumpify bump
+      - push-to-git
+  deploy:
+    docker:
+      - image: cimg/python:3.9
+    steps:
+      - checkout
+      - install-deps:
+          ver_major: 3
+          ver_minor: 9
+      - run: uv build
+      - run: uv publish --token $PYPI_TOKEN --dry-run
+      - run: uv publish --token $PYPI_TOKEN
+
+workflows:
+  test:
+    jobs:
+      - test:
+          name: "test-py39"
+          ver_major: 3
+          ver_minor: 9
+      - test:
+          name: "test-py310"
+          ver_major: 3
+          ver_minor: 10
+      - test:
+          name: "test-py311"
+          ver_major: 3
+          ver_minor: 11
+      - test:
+          name: "test-py312"
+          ver_major: 3
+          ver_minor: 12
+      - test:
+          name: "test-py313"
+          ver_major: 3
+          ver_minor: 13
+      - test:
+          name: "test-py314"
+          ver_major: 3
+          ver_minor: 14
+      - publish-coverage:
+          filters:
+            branches:
+              only: master
+      - tag:
+          requires:
+            - test-py39
+            - test-py310
+            - test-py311
+            - test-py312
+            - test-py313
+            - test-py314
+          filters:
+            branches:
+              only: master
+            tags:
+              ignore: /.*/
+      - deploy:
+          filters:
+            branches:
+              ignore: /.*/
+            tags:
+              only: /^v.*$/

pydio-0.5.0/.gitignore

@@ -0,0 +1,13 @@
+*.pyc
+__pycache__
+.mypy_cache
+.pytest_cache
+.ruff_cache
+.venv
+.coverage
+.python-version
+.reports
+*.egg-info
+dist/
+reports/
+docs/build/

pydio-0.5.0/CHANGELOG.md

@@ -0,0 +1,84 @@
+## 0.5.0 (2026-10-20)
+
+### Fix
+
+- when `OutOfScopeError` is raised from a child provider, collect it and raise summarized error
+- make tests pass on Python 3.13
+- fix package publishing
+- add CI skipping postfix to bump commits
+- detach closed scoped injector from its parent
+- use `bumpify` but as a separately installed tool
+- migrate `pyproject.toml` to PEP-621
+
+### Feat
+
+- add support for Python 3.12 and 3.13
+- add a new v1 `provides` decorator
+- create a v1 `Injector` implementation with tests
+- add v1 `AsyncInjector` implementation with tests
+- add async recursive lock implementation for a default asyncio backend
+- add `inject_annotated` and `async_inject_annotated` helpers
+- normalize exception handling
+- add support for Python 3.14
+
+## 0.4.1 (2023-05-12)
+
+### Fix
+
+- properly close injector when exception thrown in teardown phase
+
+## 0.4.0 (2023-05-06)
+
+### Fix
+
+- resolve issue #7
+
+### Feat
+
+- extend API of IFactory.close for the purpose of solving issue #7
+- add support for Python 3.11
+
+## 0.3.3 (2022-11-05)
+
+### Fix
+
+- deploy task no longer requires test jobs
+
+## 0.3.2 (2022-11-05)
+
+### Fix
+
+- fix config.yml so that the job is triggered once tag is pushed
+
+## 0.3.1 (2022-11-05)
+
+### Fix
+
+- make Changelog chapter in Sphinx documentation work again
+
+## 0.3.0 (2022-11-05)
+
+### Feat
+
+- remove compatibility layer for no longer supported Python 3.6
+
+## 0.2.1 (2022-11-05)
+
+### Fix
+
+- fix various CI issues (#6)
+
+## 0.2.0 (2022-10-30)
+
+## 0.1.0 (2021-02-15)
+
+## 0.1.0 (2021-02-10)
+
+## 0.1.0 (2021-02-04)
+
+## 0.1.0 (2021-02-04)
+
+## 0.1.0 (2021-02-04)
+
+Initial release.
+

pydio-0.5.0/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (C) Maciej Wiatrzyk <maciej.wiatrzyk@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pydio-0.5.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: PyDIO
+Version: 0.5.0
+Summary: Lightweight and functional dependency injection library for Python
+Project-URL: Homepage, https://github.com/mwiatrzyk/pydio
+Project-URL: Repository, https://github.com/mwiatrzyk/pydio
+Project-URL: Documentation, https://pydio.readthedocs.io
+Author-email: Maciej Wiatrzyk <maciej.wiatrzyk@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.txt
+Keywords: dependency,di,framework,injection,library,tool,toolkit
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Requires-Dist: typing-extensions>=4.16.0
+Description-Content-Type: text/markdown
+
+![PyPI](https://img.shields.io/pypi/v/pydio)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pydio)
+![PyPI - License](https://img.shields.io/pypi/l/pydio)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/pydio)
+[![codecov](https://codecov.io/gh/mwiatrzyk/pydio/branch/master/graph/badge.svg?token=Y6DJDSOR6M)](https://codecov.io/gh/mwiatrzyk/pydio)
+
+# 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:
+
+```python
+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:
+
+```shell
+$ 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):
+
+    ```shell
+    $ pip install PyDIO
+    ```
+
+2) From test PyPI (for stable and development releases):
+
+    ```shell
+    $ pip install -i https://test.pypi.org/simple/ PyDIO
+    ```
+
+3) Directly from source code repository (for all releases):
+
+    ```shell
+    $ pip install git+https://gitlab.com/zef1r/PyDIO.git@[branch-or-tag]
+    ```
+
+## Documentation
+
+You have two options available:
+
+1) Visit [PyDIO's ReadTheDocs](https://pydio.readthedocs.io/en/latest/) site.
+
+2) Take a tour around [functional tests](https://github.com/mwiatrzyk/pydio/tree/master/tests/functional).
+
+## 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](https://github.com/mwiatrzyk/pydio/blob/master/LICENSE.txt) for more details.
+
+## Author
+
+Maciej Wiatrzyk <maciej.wiatrzyk@gmail.com>

pydio-0.5.0/README.md

@@ -0,0 +1,118 @@
+![PyPI](https://img.shields.io/pypi/v/pydio)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pydio)
+![PyPI - License](https://img.shields.io/pypi/l/pydio)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/pydio)
+[![codecov](https://codecov.io/gh/mwiatrzyk/pydio/branch/master/graph/badge.svg?token=Y6DJDSOR6M)](https://codecov.io/gh/mwiatrzyk/pydio)
+
+# 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:
+
+```python
+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:
+
+```shell
+$ 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):
+
+    ```shell
+    $ pip install PyDIO
+    ```
+
+2) From test PyPI (for stable and development releases):
+
+    ```shell
+    $ pip install -i https://test.pypi.org/simple/ PyDIO
+    ```
+
+3) Directly from source code repository (for all releases):
+
+    ```shell
+    $ pip install git+https://gitlab.com/zef1r/PyDIO.git@[branch-or-tag]
+    ```
+
+## Documentation
+
+You have two options available:
+
+1) Visit [PyDIO's ReadTheDocs](https://pydio.readthedocs.io/en/latest/) site.
+
+2) Take a tour around [functional tests](https://github.com/mwiatrzyk/pydio/tree/master/tests/functional).
+
+## 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](https://github.com/mwiatrzyk/pydio/blob/master/LICENSE.txt) for more details.
+
+## Author
+
+Maciej Wiatrzyk <maciej.wiatrzyk@gmail.com>

pydio-0.5.0/docs/source/api/index.rst

@@ -0,0 +1,20 @@
+API Reference
+=============
+.. toctree::
+    :maxdepth: 1
+
+    pydio/api
+    pydio/base
+    pydio/exc
+    pydio/injector
+    pydio/keys
+    pydio/provider
+    pydio/v1
+    pydio/v1/api
+    pydio/v1/async_backends
+    pydio/v1/async_backends/asyncio
+    pydio/v1/exc
+    pydio/v1/helpers
+    pydio/v1/injectors
+    pydio/v1/interface
+    pydio/v1/providers

pydio-0.5.0/docs/source/api/pydio/api.rst

@@ -0,0 +1,5 @@
+**pydio.api**
+=============
+.. automodule:: pydio.api
+    :members:
+    :no-index:

pydio-0.5.0/docs/source/api/pydio/base.rst

@@ -0,0 +1,4 @@
+**pydio.base**
+==============
+.. automodule:: pydio.base
+    :members:

pydio-0.5.0/docs/source/api/pydio/exc.rst

@@ -0,0 +1,4 @@
+**pydio.exc**
+=============
+.. automodule:: pydio.exc
+    :members:

pydio-0.5.0/docs/source/api/pydio/injector.rst

@@ -0,0 +1,4 @@
+**pydio.injector**
+==================
+.. automodule:: pydio.injector
+    :members:

pydio-0.5.0/docs/source/api/pydio/keys.rst

@@ -0,0 +1,4 @@
+**pydio.keys**
+==============
+.. automodule:: pydio.keys
+    :members:

pydio-0.5.0/docs/source/api/pydio/provider.rst

@@ -0,0 +1,4 @@
+**pydio.provider**
+==================
+.. automodule:: pydio.provider
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1/api.rst

@@ -0,0 +1,5 @@
+**pydio.v1.api**
+================
+.. automodule:: pydio.v1.api
+    :members:
+    :no-index:

pydio-0.5.0/docs/source/api/pydio/v1/async_backends/asyncio.rst

@@ -0,0 +1,4 @@
+**pydio.v1.async_backends.asyncio**
+===================================
+.. automodule:: pydio.v1.async_backends.asyncio
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1/async_backends.rst

@@ -0,0 +1,4 @@
+**pydio.v1.async_backends**
+===========================
+.. automodule:: pydio.v1.async_backends
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1/exc.rst

@@ -0,0 +1,4 @@
+**pydio.v1.exc**
+================
+.. automodule:: pydio.v1.exc
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1/helpers.rst

@@ -0,0 +1,4 @@
+**pydio.v1.helpers**
+====================
+.. automodule:: pydio.v1.helpers
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1/injectors.rst

@@ -0,0 +1,4 @@
+**pydio.v1.injectors**
+======================
+.. automodule:: pydio.v1.injectors
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1/interface.rst

@@ -0,0 +1,4 @@
+**pydio.v1.interface**
+======================
+.. automodule:: pydio.v1.interface
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1/providers.rst

@@ -0,0 +1,4 @@
+**pydio.v1.providers**
+======================
+.. automodule:: pydio.v1.providers
+    :members:

pydio-0.5.0/docs/source/api/pydio/v1.rst

@@ -0,0 +1,4 @@
+**pydio.v1**
+============
+.. automodule:: pydio.v1
+    :members:

pydio-0.5.0/docs/source/changelog.rst

@@ -0,0 +1,17 @@
+.. ----------------------------------------------------------------------------
+.. docs/source/changelog.rst
+..
+.. Copyright (C) 2021 - 2025 Maciej Wiatrzyk <maciej.wiatrzyk@gmail.com>
+..
+.. This file is part of PyDio library documentation
+.. and is released under the terms of the MIT license:
+.. http://opensource.org/licenses/mit-license.php.
+..
+.. See LICENSE.txt for details.
+.. ----------------------------------------------------------------------------
+
+Changelog
+=========
+
+.. include:: ../../CHANGELOG.md
+    :parser: myst_parser.sphinx_