python-injection 0.25.7__tar.gz → 0.25.7.post0__tar.gz

python_injection-0.25.7.post0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: python-injection
+Version: 0.25.7.post0
+Summary: Fast and easy dependency injection framework.
+Project-URL: Documentation, https://python-injection.remimd.dev
+Project-URL: Repository, https://github.com/100nm/python-injection
+Author: remimd
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dependencies,dependency,inject,injection
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.12
+Requires-Dist: type-analyzer
+Provides-Extra: async
+Requires-Dist: anyio; extra == 'async'
+Description-Content-Type: text/markdown
+
+# python-injection
+
+[![PyPI - Version](https://img.shields.io/pypi/v/python-injection.svg?color=546d78&style=for-the-badge)](https://pypi.org/project/python-injection)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/python-injection.svg?color=546d78&style=for-the-badge)](https://pypistats.org/packages/python-injection)
+
+## Project motivations
+
+Dependency injection in Python has long been a source of frustration. 
+
+Existing solutions are often verbose, require extensive boilerplate, or fail to leverage Python's type hints effectively. `python-injection` was created to solve these problems once and for all by providing a simple, elegant, and powerful dependency injection framework that feels natural to Python developers.
+
+The goal is straightforward: make dependency injection so easy that you'll wonder how you ever managed without it.
+
+## Why choose python-injection?
+
+- **Type-driven resolution**: Dependencies are automatically resolved using Python's type annotations.
+- **Decorator-based registration**: Register your dependencies with simple, readable decorators.
+- **Flexible lifetimes**: Choose from 4 type of lifetimes to match your needs:
+    - **Transient**: A new instance every time
+    - **Singleton**: One instance for the entire application
+    - **Scoped**: One instance per scope, with context manager support
+    - **Constant**: Register pre-existing values
+- **Profile support**: Ability to swap certain dependencies based on a profile.
+- **Pull-based instantiation**: Dependencies are only created when needed, improving startup time and resource usage.
+- **Full sync/async support**: Works seamlessly with both synchronous and asynchronous code.
+
+## Installation
+
+Requires Python 3.12 or higher.
+```bash
+pip install python-injection
+```
+
+## Quick start
+
+Simply apply the decorators and the package takes care of the rest.
+```python
+from injection import injectable, inject, singleton
+
+@singleton
+class Printer:
+    def __init__(self):
+        self.history = []
+
+    def print(self, message: str):
+        self.history.append(message)
+        print(message)
+
+@injectable
+class Service:
+    def __init__(self, printer: Printer):
+        self.printer = printer
+
+    def hello(self):
+        self.printer.print("Hello world!")
+
+@inject
+def main(service: Service):
+    service.hello()
+
+if __name__ == "__main__":
+    main()
+```

python_injection-0.25.7.post0/docs/index.md

@@ -0,0 +1,63 @@
+# python-injection
+
+[![PyPI - Version](https://img.shields.io/pypi/v/python-injection.svg?color=546d78&style=for-the-badge)](https://pypi.org/project/python-injection)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/python-injection.svg?color=546d78&style=for-the-badge)](https://pypistats.org/packages/python-injection)
+
+## Project motivations
+
+Dependency injection in Python has long been a source of frustration. 
+
+Existing solutions are often verbose, require extensive boilerplate, or fail to leverage Python's type hints effectively. `python-injection` was created to solve these problems once and for all by providing a simple, elegant, and powerful dependency injection framework that feels natural to Python developers.
+
+The goal is straightforward: make dependency injection so easy that you'll wonder how you ever managed without it.
+
+## Why choose python-injection?
+
+- **Type-driven resolution**: Dependencies are automatically resolved using Python's type annotations.
+- **Decorator-based registration**: Register your dependencies with simple, readable decorators.
+- **Flexible lifetimes**: Choose from 4 type of lifetimes to match your needs:
+    - **Transient**: A new instance every time
+    - **Singleton**: One instance for the entire application
+    - **Scoped**: One instance per scope, with context manager support
+    - **Constant**: Register pre-existing values
+- **Profile support**: Ability to swap certain dependencies based on a profile.
+- **Pull-based instantiation**: Dependencies are only created when needed, improving startup time and resource usage.
+- **Full sync/async support**: Works seamlessly with both synchronous and asynchronous code.
+
+## Installation
+
+Requires Python 3.12 or higher.
+```bash
+pip install python-injection
+```
+
+## Quick start
+
+Simply apply the decorators and the package takes care of the rest.
+```python
+from injection import injectable, inject, singleton
+
+@singleton
+class Printer:
+    def __init__(self):
+        self.history = []
+
+    def print(self, message: str):
+        self.history.append(message)
+        print(message)
+
+@injectable
+class Service:
+    def __init__(self, printer: Printer):
+        self.printer = printer
+
+    def hello(self):
+        self.printer.print("Hello world!")
+
+@inject
+def main(service: Service):
+    service.hello()
+
+if __name__ == "__main__":
+    main()
+```

{python_injection-0.25.7 → python_injection-0.25.7.post0}/pyproject.toml

@@ -14,10 +14,10 @@ dev = [
     "pyright",
     "ruff",
 ]
-doc = [
-    "fastapi",
+docs = [
+    "mkdocs",
+    "mkdocs-material",
     "pydantic-settings",
-    "typer",
     "uvloop",
 ]
 test = [
@@ -31,11 +31,11 @@ test = [
 
 [project]
 name = "python-injection"
-version = "0.25.7"
+version = "0.25.7.post0"
 description = "Fast and easy dependency injection framework."
 license = "MIT"
 license-files = ["LICENSE"]
-readme = "README.md"
+readme = "docs/index.md"
 requires-python = ">=3.12, <3.15"
 authors = [{ name = "remimd" }]
 keywords = ["dependencies", "dependency", "inject", "injection"]
@@ -66,6 +66,7 @@ async = [
 ]
 
 [project.urls]
+Documentation = "https://python-injection.remimd.dev"
 Repository = "https://github.com/100nm/python-injection"
 
 [tool.coverage.report]
@@ -135,5 +136,5 @@ ignore = ["N818"]
 fixable = ["ALL"]
 
 [tool.uv]
-default-groups = ["bench", "dev", "doc", "test"]
+default-groups = ["bench", "dev", "docs", "test"]
 package = true

python_injection-0.25.7/PKG-INFO

@@ -1,115 +0,0 @@
-Metadata-Version: 2.4
-Name: python-injection
-Version: 0.25.7
-Summary: Fast and easy dependency injection framework.
-Project-URL: Repository, https://github.com/100nm/python-injection
-Author: remimd
-License-Expression: MIT
-License-File: LICENSE
-Keywords: dependencies,dependency,inject,injection
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Software Development :: Testing
-Classifier: Typing :: Typed
-Requires-Python: <3.15,>=3.12
-Requires-Dist: type-analyzer
-Provides-Extra: async
-Requires-Dist: anyio; extra == 'async'
-Description-Content-Type: text/markdown
-
-# python-injection
-
-[![CI](https://github.com/100nm/python-injection/actions/workflows/ci.yml/badge.svg)](https://github.com/100nm/python-injection)
-[![PyPI - Version](https://img.shields.io/pypi/v/python-injection.svg?color=blue)](https://pypi.org/project/python-injection)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/python-injection.svg?color=blue)](https://pypistats.org/packages/python-injection)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-
-## Installation
-
-⚠️ _Requires Python 3.12 or higher_
-
-```bash
-pip install python-injection
-```
-
-## Features
-
-* Automatic dependency resolution based on type hints.
-* Support for multiple dependency lifetimes: `transient`, `singleton`, `constant`, and `scoped`.
-* Works seamlessly in both `async` and `sync` environments.
-* Separation of dependency sets using modules.
-* Runtime switching between different sets of dependencies.
-* Centralized setup logic using entrypoints.
-* Built-in type annotation for easy integration with [`FastAPI`](https://github.com/fastapi/fastapi).
-* Lazy dependency resolution for optimized performance.
-
-## Motivations
-
-1. Easy to use
-2. No impact on class and function definitions
-3. No tedious configuration
-
-## Quick start
-
-Simply apply the decorators and the package takes care of the rest.
-
-```python
-from injection import injectable, inject, singleton
-
-@singleton
-class Printer:
-    def __init__(self):
-        self.history = []
-
-    def print(self, message: str):
-        self.history.append(message)
-        print(message)
-
-@injectable
-class Service:
-    def __init__(self, printer: Printer):
-        self.printer = printer
-
-    def hello(self):
-        self.printer.print("Hello world!")
-
-@inject
-def main(service: Service):
-    service.hello()
-
-if __name__ == "__main__":
-    main()
-```
-
-## Resources
-
-> ⚠️ The package isn't threadsafe by default, for better performance in single-threaded applications and those using
-> `asyncio`.
-> 
-> Non-threadsafe functions are those that resolve dependencies or define scopes. They all come with an optional 
-> parameter `threadsafe`.
-> 
-> You can set `PYTHON_INJECTION_THREADSAFE=1` in environment variables to make the package fully threadsafe. The 
-> environment variable is resolved at the **Python module level**, so be careful if the variable is defined dynamically.
-
-* [**Basic usage**](https://github.com/100nm/python-injection/tree/prod/documentation/basic-usage.md)
-* [**Scoped dependencies**](https://github.com/100nm/python-injection/tree/prod/documentation/scoped-dependencies.md)
-* [**Testing**](https://github.com/100nm/python-injection/tree/prod/documentation/testing.md)
-* [**Advanced usage**](https://github.com/100nm/python-injection/tree/prod/documentation/advanced-usage.md)
-* [**Loaders**](https://github.com/100nm/python-injection/tree/prod/documentation/loaders.md)
-* [**Entrypoint**](https://github.com/100nm/python-injection/tree/prod/documentation/entrypoint.md)
-* [**Integrations**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations)
-  * [**FastAPI**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations/fastapi.md)
-  * [**What if my framework isn't listed?**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations/unlisted-framework.md)
-* [**Concrete example**](https://github.com/100nm/python-injection-example)

python_injection-0.25.7/README.md

@@ -1,85 +0,0 @@
-# python-injection
-
-[![CI](https://github.com/100nm/python-injection/actions/workflows/ci.yml/badge.svg)](https://github.com/100nm/python-injection)
-[![PyPI - Version](https://img.shields.io/pypi/v/python-injection.svg?color=blue)](https://pypi.org/project/python-injection)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/python-injection.svg?color=blue)](https://pypistats.org/packages/python-injection)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-
-## Installation
-
-⚠️ _Requires Python 3.12 or higher_
-
-```bash
-pip install python-injection
-```
-
-## Features
-
-* Automatic dependency resolution based on type hints.
-* Support for multiple dependency lifetimes: `transient`, `singleton`, `constant`, and `scoped`.
-* Works seamlessly in both `async` and `sync` environments.
-* Separation of dependency sets using modules.
-* Runtime switching between different sets of dependencies.
-* Centralized setup logic using entrypoints.
-* Built-in type annotation for easy integration with [`FastAPI`](https://github.com/fastapi/fastapi).
-* Lazy dependency resolution for optimized performance.
-
-## Motivations
-
-1. Easy to use
-2. No impact on class and function definitions
-3. No tedious configuration
-
-## Quick start
-
-Simply apply the decorators and the package takes care of the rest.
-
-```python
-from injection import injectable, inject, singleton
-
-@singleton
-class Printer:
-    def __init__(self):
-        self.history = []
-
-    def print(self, message: str):
-        self.history.append(message)
-        print(message)
-
-@injectable
-class Service:
-    def __init__(self, printer: Printer):
-        self.printer = printer
-
-    def hello(self):
-        self.printer.print("Hello world!")
-
-@inject
-def main(service: Service):
-    service.hello()
-
-if __name__ == "__main__":
-    main()
-```
-
-## Resources
-
-> ⚠️ The package isn't threadsafe by default, for better performance in single-threaded applications and those using
-> `asyncio`.
-> 
-> Non-threadsafe functions are those that resolve dependencies or define scopes. They all come with an optional 
-> parameter `threadsafe`.
-> 
-> You can set `PYTHON_INJECTION_THREADSAFE=1` in environment variables to make the package fully threadsafe. The 
-> environment variable is resolved at the **Python module level**, so be careful if the variable is defined dynamically.
-
-* [**Basic usage**](https://github.com/100nm/python-injection/tree/prod/documentation/basic-usage.md)
-* [**Scoped dependencies**](https://github.com/100nm/python-injection/tree/prod/documentation/scoped-dependencies.md)
-* [**Testing**](https://github.com/100nm/python-injection/tree/prod/documentation/testing.md)
-* [**Advanced usage**](https://github.com/100nm/python-injection/tree/prod/documentation/advanced-usage.md)
-* [**Loaders**](https://github.com/100nm/python-injection/tree/prod/documentation/loaders.md)
-* [**Entrypoint**](https://github.com/100nm/python-injection/tree/prod/documentation/entrypoint.md)
-* [**Integrations**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations)
-  * [**FastAPI**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations/fastapi.md)
-  * [**What if my framework isn't listed?**](https://github.com/100nm/python-injection/tree/prod/documentation/integrations/unlisted-framework.md)
-* [**Concrete example**](https://github.com/100nm/python-injection-example)