anydi 0.55.1__py3-none-any.whl → 0.57.0__py3-none-any.whl

anydi-0.57.0.dist-info/METADATA

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: anydi
+Version: 0.57.0
+Summary: Dependency Injection library
+Keywords: dependency injection,dependencies,di,async,asyncio,application
+Author: Anton Ruhlov
+Author-email: Anton Ruhlov <antonruhlov@gmail.com>
+License-Expression: MIT
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: typing-extensions>=4.15.0,<5
+Requires-Dist: anyio>=3.7.1
+Requires-Dist: wrapt>=1.17.0
+Requires-Python: >=3.10.0, <3.15
+Project-URL: Repository, https://github.com/antonrh/anydi
+Description-Content-Type: text/markdown
+
+# AnyDI
+
+<div style="text-align: center;">
+
+Modern, lightweight Dependency Injection library using type annotations.
+
+[![CI](https://github.com/antonrh/anydi/actions/workflows/ci.yml/badge.svg)](https://github.com/antonrh/anydi/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/antonrh/anydi/branch/main/graph/badge.svg)](https://codecov.io/gh/antonrh/anydi)
+[![Documentation](https://readthedocs.org/projects/anydi/badge/?version=latest)](https://anydi.readthedocs.io/en/latest/)
+
+</div>
+
+---
+Documentation
+
+http://anydi.readthedocs.io/
+
+---
+
+`AnyDI` is a modern, lightweight Dependency Injection library suitable for any synchronous or asynchronous applications with Python 3.10+, based on type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
+
+The key features are:
+
+* **Type-safe**: Dependency resolution is driven by type hints.
+* **Async-ready**: Works the same for sync and async providers or injections.
+* **Scoped**: Built-in singleton, transient, and request lifetimes.
+* **Simple**: Small surface area keeps boilerplate low.
+* **Fast**: Resolver still adds only microseconds of overhead.
+* **Named**: `Annotated[...]` makes multiple bindings per type simple.
+* **Managed**: Providers can open/close resources via context managers.
+* **Modular**: Compose containers or modules for large apps.
+* **Scanning**: Auto-discovers injectable callables.
+* **Integrated**: Extensions for popular frameworks.
+* **Testable**: Override providers directly in tests.
+
+## Installation
+
+```shell
+pip install anydi
+```
+
+## Comprehensive Example
+
+### Define a Service (`app/services.py`)
+
+```python
+class GreetingService:
+    def greet(self, name: str) -> str:
+        return f"Hello, {name}!"
+```
+
+### Create the Container and Providers (`app/container.py`)
+
+```python
+from anydi import Container
+
+from app.services import GreetingService
+
+
+container = Container()
+
+
+@container.provider(scope="singleton")
+def service() -> GreetingService:
+    return GreetingService()
+```
+
+### Resolve Dependencies Directly
+
+```python
+from app.container import container
+from app.services import GreetingService
+
+
+service = container.resolve(GreetingService)
+
+if __name__ == "__main__":
+    print(service.greet("World"))
+```
+
+### Inject Into Functions (`app/main.py`)
+
+```python
+from anydi import Provide
+
+from app.container import container
+from app.services import GreetingService
+
+
+def greet(service: Provide[GreetingService]) -> str:
+    return service.greet("World")
+
+
+if __name__ == "__main__":
+    print(container.run(greet))
+```
+
+### Test with Overrides (`tests/test_app.py`)
+
+```python
+from unittest import mock
+
+from app.container import container
+from app.services import GreetingService
+from app.main import greet
+
+
+def test_greet() -> None:
+    service_mock = mock.Mock(spec=GreetingService)
+    service_mock.greet.return_value = "Mocked"
+
+    with container.override(GreetingService, service_mock):
+        result = container.run(greet)
+
+    assert result == "Mocked"
+```
+
+### Integrate with FastAPI (`app/api.py`)
+
+```python
+from typing import Annotated
+
+import anydi.ext.fastapi
+from fastapi import FastAPI
+
+from anydi import Provide
+from app.container import container
+from app.services import GreetingService
+
+
+app = FastAPI()
+
+
+@app.get("/greeting")
+async def greet(
+    service: Provide[GreetingService]
+) -> dict[str, str]:
+    return {"greeting": service.greet("World")}
+
+
+anydi.ext.fastapi.install(app, container)
+```
+
+### Test the FastAPI Integration (`test_api.py`)
+
+```python
+from unittest import mock
+
+from fastapi.testclient import TestClient
+
+from app.api import app
+from app.container import container
+from app.services import GreetingService
+
+
+client = TestClient(app)
+
+
+def test_api_greeting() -> None:
+    service_mock = mock.Mock(spec=GreetingService)
+    service_mock.greet.return_value = "Mocked"
+
+    with container.override(GreetingService, service_mock):
+        response = client.get("/greeting")
+
+    assert response.json() == {"greeting": "Mocked"}
+```
+
+### Integrate with Django Ninja
+
+Install the Django integration extras:
+
+```sh
+pip install 'anydi-django[ninja]'
+```
+
+Expose the container factory (`app/container.py`):
+
+```python
+from anydi import Container
+
+from app.services import GreetingService
+
+
+container = Container()
+
+
+@container.provider(scope="singleton")
+def service() -> GreetingService:
+    return GreetingService()
+```
+
+Configure Django (`settings.py`):
+
+```python
+INSTALLED_APPS = [
+    ...
+    "anydi_django",
+]
+
+ANYDI = {
+    "CONTAINER_FACTORY": "app.container.container",
+    "PATCH_NINJA": True,
+}
+```
+
+Wire Django Ninja (`urls.py`):
+
+```python
+from typing import Annotated, Any
+
+from anydi import Provide
+from django.http import HttpRequest
+from django.urls import path
+from ninja import NinjaAPI
+
+from app.services import GreetingService
+
+
+api = NinjaAPI()
+
+
+@api.get("/greeting")
+def greet(request: HttpRequest, service: Provide[GreetingService]) -> Any:
+    return {"greeting": service.greet("World")}
+
+
+urlpatterns = [
+    path("api/", api.urls),
+]
+```

anydi-0.57.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+anydi/__init__.py,sha256=bQKzn9qfNnIMi1m3J-DdSknSDwNg8j08fdQg_-Edkto,613
+anydi/_async_lock.py,sha256=3dwZr0KthXFYha0XKMyXf8jMmGb1lYoNC0O5w29V9ic,1104
+anydi/_container.py,sha256=Zdy0KtOVRlyBSblAk2MEFp13RwJkfljpB2szR5VTHQQ,22975
+anydi/_context.py,sha256=-9QqeMWo9OpZVXZxZCQgIsswggl3Ch7lgx1KiFX_ezc,3752
+anydi/_decorators.py,sha256=J3W261ZAG7q4XKm4tbAv1wsWr9ysx9_5MUbUvSJB_MQ,2809
+anydi/_injector.py,sha256=IxKTh2rzMHrsW554tbiJl33Hb5sRGKYY_NU1rC4UvxE,4378
+anydi/_module.py,sha256=2kN5uEXLd2Dsc58gz5IWK43wJewr_QgIVGSO3iWp798,2609
+anydi/_provider.py,sha256=OV1WFHTYv7W2U0XDk_Kql1r551Vhq8o-pUV5ep1HQcU,1574
+anydi/_resolver.py,sha256=-MF2KsERF5qzU6uqYPF1fI58isgsjxXPLERylzFFDHE,28787
+anydi/_scanner.py,sha256=rbRkHzyd2zMu7AFLffN6_tZJcMaW9gy7E-lVdHLHYrs,4294
+anydi/_types.py,sha256=gpanGqXjF9WQFFn62kyIod6m1dE97vV-L2u2Y2nWie8,2933
+anydi/ext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anydi/ext/django/__init__.py,sha256=Ve8lncLU9dPY_Vjt4zihPgsSxwAtFHACn0XvBM5JG8k,367
+anydi/ext/fastapi.py,sha256=8kXdO6RPwRbPyUh6YirdEPE-clJKXE--n-TAYI2hZf8,2326
+anydi/ext/faststream.py,sha256=XT80r1FGL-xlU7r8urm9sNpUfl4OPMJseW4dade_fR4,1836
+anydi/ext/pydantic_settings.py,sha256=jVJZ1wPaPpsxdNPlJj9yq282ebqLZ9tckWpZ0eIwWLg,1533
+anydi/ext/pytest_plugin.py,sha256=M54DkA-KxD9GqLnXdoCyn-Qur2c44MB6d0AgJuYCZ5w,16171
+anydi/ext/starlette/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anydi/ext/starlette/middleware.py,sha256=MxnzshAs-CMvjJp0r457k52MzBL8O4KAuClnF6exBdU,803
+anydi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anydi/testing.py,sha256=cHg3mMScZbEep9smRqSNQ81BZMQOkyugHe8TvKdPnEg,1347
+anydi-0.57.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+anydi-0.57.0.dist-info/entry_points.txt,sha256=AgOcQYM5KyS4D37QcYb00tiid0QA-pD1VrjHHq4QAps,44
+anydi-0.57.0.dist-info/METADATA,sha256=w3aIoTTCQHgCRT1X-JnQ_VrEUz1hUl--PcktWO8fw2M,6534
+anydi-0.57.0.dist-info/RECORD,,

anydi-0.55.1.dist-info/METADATA

@@ -1,193 +0,0 @@
-Metadata-Version: 2.4
-Name: anydi
-Version: 0.55.1
-Summary: Dependency Injection library
-Keywords: dependency injection,dependencies,di,async,asyncio,application
-Author: Anton Ruhlov
-Author-email: Anton Ruhlov <antonruhlov@gmail.com>
-License-Expression: MIT
-Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: System Administrators
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Topic :: Internet
-Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development
-Classifier: Typing :: Typed
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-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 :: 3.14
-Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Dist: typing-extensions>=4.15.0,<5
-Requires-Dist: anyio>=3.7.1
-Requires-Dist: wrapt>=1.17.0,<2
-Requires-Python: >=3.10.0, <3.15
-Project-URL: Repository, https://github.com/antonrh/anydi
-Description-Content-Type: text/markdown
-
-# AnyDI
-
-<div style="text-align: center;">
-
-Modern, lightweight Dependency Injection library using type annotations.
-
-[![CI](https://github.com/antonrh/anydi/actions/workflows/ci.yml/badge.svg)](https://github.com/antonrh/anydi/actions/workflows/ci.yml)
-[![Coverage](https://codecov.io/gh/antonrh/anydi/branch/main/graph/badge.svg)](https://codecov.io/gh/antonrh/anydi)
-[![Documentation](https://readthedocs.org/projects/anydi/badge/?version=latest)](https://anydi.readthedocs.io/en/latest/)
-
-</div>
-
----
-Documentation
-
-http://anydi.readthedocs.io/
-
----
-
-`AnyDI` is a modern, lightweight Dependency Injection library suitable for any synchronous or asynchronous applications with Python 3.10+, based on type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
-
-The key features are:
-
-* **Type-safe**: Resolves dependencies using type annotations.
-* **Async Support**: Compatible with both synchronous and asynchronous providers and injections.
-* **Scoping**: Supports singleton, transient, and request scopes.
-* **Easy to Use**: Designed for simplicity and minimal boilerplate.
-* **Named Dependencies**: Supports named dependencies using `Annotated` type.
-* **Resource Management**: Manages resources using context managers.
-* **Modular: Facilitates** a modular design with support for multiple modules.
-* **Scanning**: Automatically scans for injectable functions and classes.
-* **Integrations**: Provides easy integration with popular frameworks and libraries.
-* **Testing**: Simplifies testing by allowing provider overrides.
-
-## Installation
-
-```shell
-pip install anydi
-```
-
-## Quick Example
-
-*app.py*
-
-```python
-from anydi import auto, Container
-
-container = Container()
-
-
-@container.provider(scope="singleton")
-def message() -> str:
-    return "Hello, World!"
-
-
-@container.inject
-def say_hello(message: str = auto) -> None:
-    print(message)
-
-
-if __name__ == "__main__":
-    say_hello()
-```
-
-## FastAPI Example
-
-*app.py*
-
-```python
-from typing import Annotated
-
-from fastapi import FastAPI
-
-import anydi.ext.fastapi
-from anydi import Container
-from anydi.ext.fastapi import Inject
-
-container = Container()
-
-
-@container.provider(scope="singleton")
-def message() -> str:
-    return "Hello, World!"
-
-
-app = FastAPI()
-
-
-@app.get("/hello")
-def say_hello(message: Annotated[str, Inject()]) -> dict[str, str]:
-    return {"message": message}
-
-
-# Install the container into the FastAPI app
-anydi.ext.fastapi.install(app, container)
-```
-
-
-
-## Django Ninja Example
-
-### Install
-
-```sh
-pip install 'anydi-django[ninja]'
-```
-
-*container.py*
-
-```python
-from anydi import Container
-
-
-def get_container() -> Container:
-    container = Container()
-
-    @container.provider(scope="singleton")
-    def message() -> str:
-        return "Hello, World!"
-
-    return container
-```
-
-*settings.py*
-
-```python
-INSTALLED_APPS = [
-    ...
-    "anydi_django",
-]
-
-ANYDI = {
-    "CONTAINER_FACTORY": "myapp.container.get_container",
-    "PATCH_NINJA": True,
-}
-```
-
-*urls.py*
-
-```python
-from django.http import HttpRequest
-from django.urls import path
-from ninja import NinjaAPI
-
-from anydi import auto
-
-api = NinjaAPI()
-
-
-@api.get("/hello")
-def say_hello(request: HttpRequest, message: str = auto) -> dict[str, str]:
-    return {"message": message}
-
-
-urlpatterns = [
-    path("api/", api.urls),
-]
-```

anydi-0.55.1.dist-info/RECORD

@@ -1,24 +0,0 @@
-anydi/__init__.py,sha256=Cz-beqReX0d05SFDmYcrzIs3FqQkWAwpy1Aqzd5db34,547
-anydi/_async_lock.py,sha256=3dwZr0KthXFYha0XKMyXf8jMmGb1lYoNC0O5w29V9ic,1104
-anydi/_container.py,sha256=6C8LM9PxMahKnu7YLMGJ50dPzYLRknZ9G9RKwyB18wE,24853
-anydi/_context.py,sha256=-9QqeMWo9OpZVXZxZCQgIsswggl3Ch7lgx1KiFX_ezc,3752
-anydi/_decorators.py,sha256=J3W261ZAG7q4XKm4tbAv1wsWr9ysx9_5MUbUvSJB_MQ,2809
-anydi/_module.py,sha256=2kN5uEXLd2Dsc58gz5IWK43wJewr_QgIVGSO3iWp798,2609
-anydi/_provider.py,sha256=OV1WFHTYv7W2U0XDk_Kql1r551Vhq8o-pUV5ep1HQcU,1574
-anydi/_resolver.py,sha256=olWUYp0PfsWUt7hp2MW69734T29ck6fu3s7Nk4-U7rU,25183
-anydi/_scanner.py,sha256=oycIC9kw9fsIG9qgtRHeBkj3HjmcLK0FTqWLXTLLSWE,3636
-anydi/_types.py,sha256=l3xQ0Zn15gRAwvBoQ9PRfCBigi2rrtSqGV-C50xXrLw,1780
-anydi/ext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-anydi/ext/django/__init__.py,sha256=Ve8lncLU9dPY_Vjt4zihPgsSxwAtFHACn0XvBM5JG8k,367
-anydi/ext/fastapi.py,sha256=FflFBdK-moyv9Vsfem4NyNt8jgPwFLweeCl5cfU0Iks,2348
-anydi/ext/faststream.py,sha256=dJPInvi0JUx-SS8H4aBRl3u-PAW6S_TqqfxVOl3D1L0,1929
-anydi/ext/pydantic_settings.py,sha256=0GQjw7QpQlT5p6GxFClXYdtc6J42PClmAnRWPEzMjvY,1488
-anydi/ext/pytest_plugin.py,sha256=Es1K1S6_2gIdTUYkbw2d1aZcHnjJutGFafVsLPGcVJc,4684
-anydi/ext/starlette/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-anydi/ext/starlette/middleware.py,sha256=MxnzshAs-CMvjJp0r457k52MzBL8O4KAuClnF6exBdU,803
-anydi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-anydi/testing.py,sha256=JNXA-XGjkU7PMturkzDzumDcLlnYOLzCtBUQ9HyQMLM,4309
-anydi-0.55.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-anydi-0.55.1.dist-info/entry_points.txt,sha256=AgOcQYM5KyS4D37QcYb00tiid0QA-pD1VrjHHq4QAps,44
-anydi-0.55.1.dist-info/METADATA,sha256=TEL8yqko7Et9BJW8uiUq8r-Hjjj5PcYYXBS91eHTuPE,4799
-anydi-0.55.1.dist-info/RECORD,,