dependency-injection-pattern 0.0.0__tar.gz

dependency_injection_pattern-0.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Dagrofa BI
+
+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.

dependency_injection_pattern-0.0.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: dependency-injection-pattern
+Version: 0.0.0
+Summary: Python implementation of the Dependency Injection pattern.
+Author-email: Anders Madsen <anders.madsen@alphavue.com>
+License: MIT
+Project-URL: repository, https://github.com/apmadsen/dependency-injection-pattern
+Keywords: windows,linux,dependency injection,di,dependency,injection,IoC
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Development Status :: 6 - Mature
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing-utilities==0.0.2
+Provides-Extra: test
+Requires-Dist: pytest>=8.3; extra == "test"
+Requires-Dist: pytest-cov>=6.1; extra == "test"
+Dynamic: license-file
+
+[![Test](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test.yml/badge.svg)](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test.yml)
+[![Coverage](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test-coverage.yml/badge.svg)](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test-coverage.yml)
+[![Stable Version](https://img.shields.io/pypi/v/dependency-injection-pattern?label=stable&sort=semver&color=blue)](https://github.com/apmadsen/dependency-injection-pattern/releases)
+![Pre-release Version](https://img.shields.io/github/v/release/apmadsen/dependency-injection-pattern?label=pre-release&include_prereleases&sort=semver&color=blue)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dependency-injection-pattern)
+[![PyPI Downloads](https://static.pepy.tech/badge/dependency-injection-pattern/week)](https://pepy.tech/projects/dependency-injection-pattern)
+
+# dependency-injection-pattern
+> A Python implementation of the Dependency Injection pattern.
+
+This project extends python with a real dependency injection or Inversion of Control (IoC) implementation, relying on typing and inspection to achieve a seamless injection of dependencies.
+
+Though not normally associated with Python applications, dependency injection can greatly reduce time spent during development and testing. Usually, in a longrunning Python application or service, you would put the container registration inside the `__main_.py` file and similar code in test files, where service implementations can easily be substituted.
+
+## How it works
+When a service is requested, the provider looks it up in the factory dictionary, which then gets or creates a fitting instance. Any parameters needed for instantiation is supplied (injected) by the provider.
+
+A service implementation may be inferred by a service in which case the service constructor is used, and correspondingly a service may be inferred by the return type of an implementation function.
+
+## Conventions
+- All dependencies are resolved when container is sealed, which implements a fail-fast pattern. Only exceptions are optional dependencies or dependencies with a default value.
+
+- Singleton services may not depend on scoped or transient services, as this would negate the "transient" or "scoped" part since a singleton service would keep a reference to it's dependencies indefinitely.
+
+## Example:
+
+```python
+from logging import Logger
+from di import Container
+
+def get_logger() -> Logger:
+    return Logger("app")
+
+class Service1:
+    def get_value(self) -> str:
+        return "Some value"
+
+class Service2:
+    def __init__(self, service1: Service1, log: Logger):
+        self.service1 = service1
+        self.log = log
+
+    def get_value(self) -> str:
+        self.log.debug("Someone requested value...")
+        return f"Service1 returned: {self.service1.get_value()}"
+
+class Application:
+    def __init__(self, service2: Service2, log: Logger):
+        self.service2 = service2
+        log.info("Application starting")
+
+    def get_value(self) -> str:
+        return f"Service2 returned: {self.service2.get_value()}"
+
+
+container = Container()
+container.add_singleton(get_logger)
+container.add_transient(Service1)
+container.add_transient(Service2)
+container.add_transient(Application)
+
+provider = container.provider() # container is sealed beyond this point
+
+app = provider.provide(Application)
+
+value = app.get_value() # => "Service2 returned: Service1 returned: Some value"
+```
+
+## API
+
+[Go to API documentation](https://github.com/apmadsen/dependency-injection-pattern/blob/main/docs/api.md)

dependency_injection_pattern-0.0.0/README.md

@@ -0,0 +1,71 @@
+[![Test](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test.yml/badge.svg)](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test.yml)
+[![Coverage](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test-coverage.yml/badge.svg)](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test-coverage.yml)
+[![Stable Version](https://img.shields.io/pypi/v/dependency-injection-pattern?label=stable&sort=semver&color=blue)](https://github.com/apmadsen/dependency-injection-pattern/releases)
+![Pre-release Version](https://img.shields.io/github/v/release/apmadsen/dependency-injection-pattern?label=pre-release&include_prereleases&sort=semver&color=blue)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dependency-injection-pattern)
+[![PyPI Downloads](https://static.pepy.tech/badge/dependency-injection-pattern/week)](https://pepy.tech/projects/dependency-injection-pattern)
+
+# dependency-injection-pattern
+> A Python implementation of the Dependency Injection pattern.
+
+This project extends python with a real dependency injection or Inversion of Control (IoC) implementation, relying on typing and inspection to achieve a seamless injection of dependencies.
+
+Though not normally associated with Python applications, dependency injection can greatly reduce time spent during development and testing. Usually, in a longrunning Python application or service, you would put the container registration inside the `__main_.py` file and similar code in test files, where service implementations can easily be substituted.
+
+## How it works
+When a service is requested, the provider looks it up in the factory dictionary, which then gets or creates a fitting instance. Any parameters needed for instantiation is supplied (injected) by the provider.
+
+A service implementation may be inferred by a service in which case the service constructor is used, and correspondingly a service may be inferred by the return type of an implementation function.
+
+## Conventions
+- All dependencies are resolved when container is sealed, which implements a fail-fast pattern. Only exceptions are optional dependencies or dependencies with a default value.
+
+- Singleton services may not depend on scoped or transient services, as this would negate the "transient" or "scoped" part since a singleton service would keep a reference to it's dependencies indefinitely.
+
+## Example:
+
+```python
+from logging import Logger
+from di import Container
+
+def get_logger() -> Logger:
+    return Logger("app")
+
+class Service1:
+    def get_value(self) -> str:
+        return "Some value"
+
+class Service2:
+    def __init__(self, service1: Service1, log: Logger):
+        self.service1 = service1
+        self.log = log
+
+    def get_value(self) -> str:
+        self.log.debug("Someone requested value...")
+        return f"Service1 returned: {self.service1.get_value()}"
+
+class Application:
+    def __init__(self, service2: Service2, log: Logger):
+        self.service2 = service2
+        log.info("Application starting")
+
+    def get_value(self) -> str:
+        return f"Service2 returned: {self.service2.get_value()}"
+
+
+container = Container()
+container.add_singleton(get_logger)
+container.add_transient(Service1)
+container.add_transient(Service2)
+container.add_transient(Application)
+
+provider = container.provider() # container is sealed beyond this point
+
+app = provider.provide(Application)
+
+value = app.get_value() # => "Service2 returned: Service1 returned: Some value"
+```
+
+## API
+
+[Go to API documentation](https://github.com/apmadsen/dependency-injection-pattern/blob/main/docs/api.md)

dependency_injection_pattern-0.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "dependency-injection-pattern"
+dynamic = ["version"]
+description = "Python implementation of the Dependency Injection pattern."
+keywords = ["windows", "linux", "dependency injection", "di", "dependency", "injection", "IoC"]
+readme = "README.md"
+authors = [
+    { name = "Anders Madsen", email = "anders.madsen@alphavue.com" }
+]
+license = { text = "MIT" }
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Development Status :: 6 - Mature",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed"
+]
+dependencies = [
+    "typing-utilities==0.0.2"
+]
+requires-python = ">=3.10"
+
+[project.urls]
+repository = "https://github.com/apmadsen/dependency-injection-pattern"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.3",
+    "pytest-cov>=6.1",
+]
+
+[tool.setuptools-git-versioning]
+enabled = true
+
+[build-system]
+requires = ["setuptools >= 77.0.3", "setuptools-git-versioning >= 2.1.0"]
+build-backend = "setuptools.build_meta"

dependency_injection_pattern-0.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dependency_injection_pattern-0.0.0/src/dependency_injection_pattern.egg-info/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: dependency-injection-pattern
+Version: 0.0.0
+Summary: Python implementation of the Dependency Injection pattern.
+Author-email: Anders Madsen <anders.madsen@alphavue.com>
+License: MIT
+Project-URL: repository, https://github.com/apmadsen/dependency-injection-pattern
+Keywords: windows,linux,dependency injection,di,dependency,injection,IoC
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Development Status :: 6 - Mature
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing-utilities==0.0.2
+Provides-Extra: test
+Requires-Dist: pytest>=8.3; extra == "test"
+Requires-Dist: pytest-cov>=6.1; extra == "test"
+Dynamic: license-file
+
+[![Test](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test.yml/badge.svg)](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test.yml)
+[![Coverage](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test-coverage.yml/badge.svg)](https://github.com/apmadsen/dependency-injection-pattern/actions/workflows/python-test-coverage.yml)
+[![Stable Version](https://img.shields.io/pypi/v/dependency-injection-pattern?label=stable&sort=semver&color=blue)](https://github.com/apmadsen/dependency-injection-pattern/releases)
+![Pre-release Version](https://img.shields.io/github/v/release/apmadsen/dependency-injection-pattern?label=pre-release&include_prereleases&sort=semver&color=blue)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dependency-injection-pattern)
+[![PyPI Downloads](https://static.pepy.tech/badge/dependency-injection-pattern/week)](https://pepy.tech/projects/dependency-injection-pattern)
+
+# dependency-injection-pattern
+> A Python implementation of the Dependency Injection pattern.
+
+This project extends python with a real dependency injection or Inversion of Control (IoC) implementation, relying on typing and inspection to achieve a seamless injection of dependencies.
+
+Though not normally associated with Python applications, dependency injection can greatly reduce time spent during development and testing. Usually, in a longrunning Python application or service, you would put the container registration inside the `__main_.py` file and similar code in test files, where service implementations can easily be substituted.
+
+## How it works
+When a service is requested, the provider looks it up in the factory dictionary, which then gets or creates a fitting instance. Any parameters needed for instantiation is supplied (injected) by the provider.
+
+A service implementation may be inferred by a service in which case the service constructor is used, and correspondingly a service may be inferred by the return type of an implementation function.
+
+## Conventions
+- All dependencies are resolved when container is sealed, which implements a fail-fast pattern. Only exceptions are optional dependencies or dependencies with a default value.
+
+- Singleton services may not depend on scoped or transient services, as this would negate the "transient" or "scoped" part since a singleton service would keep a reference to it's dependencies indefinitely.
+
+## Example:
+
+```python
+from logging import Logger
+from di import Container
+
+def get_logger() -> Logger:
+    return Logger("app")
+
+class Service1:
+    def get_value(self) -> str:
+        return "Some value"
+
+class Service2:
+    def __init__(self, service1: Service1, log: Logger):
+        self.service1 = service1
+        self.log = log
+
+    def get_value(self) -> str:
+        self.log.debug("Someone requested value...")
+        return f"Service1 returned: {self.service1.get_value()}"
+
+class Application:
+    def __init__(self, service2: Service2, log: Logger):
+        self.service2 = service2
+        log.info("Application starting")
+
+    def get_value(self) -> str:
+        return f"Service2 returned: {self.service2.get_value()}"
+
+
+container = Container()
+container.add_singleton(get_logger)
+container.add_transient(Service1)
+container.add_transient(Service2)
+container.add_transient(Application)
+
+provider = container.provider() # container is sealed beyond this point
+
+app = provider.provide(Application)
+
+value = app.get_value() # => "Service2 returned: Service1 returned: Some value"
+```
+
+## API
+
+[Go to API documentation](https://github.com/apmadsen/dependency-injection-pattern/blob/main/docs/api.md)

dependency_injection_pattern-0.0.0/src/dependency_injection_pattern.egg-info/SOURCES.txt

@@ -0,0 +1,43 @@
+LICENSE
+README.md
+pyproject.toml
+src/dependency_injection_pattern.egg-info/PKG-INFO
+src/dependency_injection_pattern.egg-info/SOURCES.txt
+src/dependency_injection_pattern.egg-info/dependency_links.txt
+src/dependency_injection_pattern.egg-info/requires.txt
+src/dependency_injection_pattern.egg-info/top_level.txt
+src/di/__init__.py
+src/di/exceptions.py
+src/di/core/container.py
+src/di/core/default_scope.py
+src/di/core/factory.py
+src/di/core/helpers.py
+src/di/core/log.py
+src/di/core/named_service.py
+src/di/core/provider.py
+src/di/core/scope.py
+src/di/core/service_request.py
+src/di/core/exceptions/add_exception.py
+src/di/core/exceptions/container_sealed_error.py
+src/di/core/exceptions/factory_provide_exception.py
+src/di/core/exceptions/implementation_exception.py
+src/di/core/exceptions/provide_exception.py
+src/di/core/exceptions/seal_exception.py
+src/di/core/factories/dependency.py
+src/di/core/factories/factory.py
+src/di/core/factories/scoped_factory.py
+src/di/core/factories/singleton_factory.py
+src/di/core/factories/transient_factory.py
+src/di/core/protocols/container.py
+src/di/core/protocols/factory.py
+src/di/core/protocols/provider.py
+src/di/core/reflection/__init__.py
+src/di/core/reflection/parameter.py
+src/di/core/reflection/parameter_kind.py
+src/di/core/reflection/parameter_mapper.py
+src/di/core/reflection/signature.py
+src/di/core/reflection/undefined.py
+tests/test_container.py
+tests/test_examples.py
+tests/test_factory.py
+tests/test_provider.py

dependency_injection_pattern-0.0.0/src/dependency_injection_pattern.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dependency_injection_pattern-0.0.0/src/dependency_injection_pattern.egg-info/requires.txt

@@ -0,0 +1,5 @@
+typing-utilities==0.0.2
+
+[test]
+pytest>=8.3
+pytest-cov>=6.1

dependency_injection_pattern-0.0.0/src/dependency_injection_pattern.egg-info/top_level.txt

@@ -0,0 +1 @@
+di

dependency_injection_pattern-0.0.0/src/di/__init__.py

@@ -0,0 +1,13 @@
+from di.core.container import Container
+from di.core.provider import Provider
+from di.core.scope import Scope
+from di.core.default_scope import DefaultScope
+from di.core.factory import Factory
+
+__all__ = [
+    'Container',
+    'Provider',
+    'Scope',
+    'DefaultScope',
+    'Factory'
+]