anydi 0.56.0__tar.gz → 0.58.0__tar.gz

{anydi-0.56.0 → anydi-0.58.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anydi
-Version: 0.56.0
+Version: 0.58.0
 Summary: Dependency Injection library
 Keywords: dependency injection,dependencies,di,async,asyncio,application
 Author: Anton Ruhlov
@@ -58,9 +58,9 @@ 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.
+* **Scoped**: Built-in singleton, transient, and request scopes, plus custom scopes.
 * **Simple**: Small surface area keeps boilerplate low.
-* **Fast**: Resolver still adds only microseconds of overhead.
+* **Fast**: Has minimal overhead and resolves dependencies quickly.
 * **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.
@@ -74,7 +74,7 @@ The key features are:
 pip install anydi
 ```
 
-## Comprehensive Example
+## Quick Example
 
 ### Define a Service (`app/services.py`)
 
@@ -116,19 +116,18 @@ if __name__ == "__main__":
 ### Inject Into Functions (`app/main.py`)
 
 ```python
-from anydi import Inject
+from anydi import Provide
 
 from app.container import container
 from app.services import GreetingService
 
 
-@container.inject
-def greet(service: GreetingService = Inject()) -> str:
+def greet(service: Provide[GreetingService]) -> str:
     return service.greet("World")
 
 
 if __name__ == "__main__":
-    print(greet())
+    print(container.run(greet))
 ```
 
 ### Test with Overrides (`tests/test_app.py`)
@@ -146,7 +145,7 @@ def test_greet() -> None:
     service_mock.greet.return_value = "Mocked"
 
     with container.override(GreetingService, service_mock):
-        result = greet()
+        result = container.run(greet)
 
     assert result == "Mocked"
 ```
@@ -158,8 +157,8 @@ from typing import Annotated
 
 import anydi.ext.fastapi
 from fastapi import FastAPI
-from anydi.ext.fastapi import Inject
 
+from anydi import Provide
 from app.container import container
 from app.services import GreetingService
 
@@ -169,7 +168,7 @@ app = FastAPI()
 
 @app.get("/greeting")
 async def greet(
-    service: Annotated[GreetingService, Inject()]
+    service: Provide[GreetingService]
 ) -> dict[str, str]:
     return {"greeting": service.greet("World")}
 
@@ -245,7 +244,7 @@ Wire Django Ninja (`urls.py`):
 ```python
 from typing import Annotated, Any
 
-from anydi import Inject
+from anydi import Provide
 from django.http import HttpRequest
 from django.urls import path
 from ninja import NinjaAPI
@@ -257,7 +256,7 @@ api = NinjaAPI()
 
 
 @api.get("/greeting")
-def greet(request: HttpRequest, service: Annotated[GreetingService, Inject()]) -> Any:
+def greet(request: HttpRequest, service: Provide[GreetingService]) -> Any:
     return {"greeting": service.greet("World")}
 
 
@@ -265,3 +264,23 @@ urlpatterns = [
     path("api/", api.urls),
 ]
 ```
+
+## What's Next?
+
+Ready to learn more? Check out these resources:
+
+**Core Documentation:**
+- [Core Concepts](https://anydi.readthedocs.io/en/latest/concepts/) - Understand containers, providers, scopes, and dependency injection
+- [Providers](https://anydi.readthedocs.io/en/latest/usage/providers/) - Learn about registration, named providers, and resource management
+- [Scopes](https://anydi.readthedocs.io/en/latest/usage/scopes/) - Master lifecycle management with built-in and custom scopes
+- [Dependency Injection](https://anydi.readthedocs.io/en/latest/usage/injection/) - Explore injection patterns and techniques
+- [Testing](https://anydi.readthedocs.io/en/latest/usage/testing/) - Write testable code with provider overrides
+
+**Framework Integrations:**
+- [FastAPI](https://anydi.readthedocs.io/en/latest/extensions/fastapi/) - Build modern APIs with automatic dependency injection
+- [Django](https://anydi.readthedocs.io/en/latest/extensions/django/) - Integrate with Django and Django Ninja
+- [FastStream](https://anydi.readthedocs.io/en/latest/extensions/faststream/) - Message broker applications
+- [Pydantic Settings](https://anydi.readthedocs.io/en/latest/extensions/pydantic_settings/) - Configuration management
+
+**Full Documentation:**
+- [Read the Docs](https://anydi.readthedocs.io/) - Complete documentation with examples and guides

{anydi-0.56.0 → anydi-0.58.0}/README.md

@@ -23,9 +23,9 @@ 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.
+* **Scoped**: Built-in singleton, transient, and request scopes, plus custom scopes.
 * **Simple**: Small surface area keeps boilerplate low.
-* **Fast**: Resolver still adds only microseconds of overhead.
+* **Fast**: Has minimal overhead and resolves dependencies quickly.
 * **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.
@@ -39,7 +39,7 @@ The key features are:
 pip install anydi
 ```
 
-## Comprehensive Example
+## Quick Example
 
 ### Define a Service (`app/services.py`)
 
@@ -81,19 +81,18 @@ if __name__ == "__main__":
 ### Inject Into Functions (`app/main.py`)
 
 ```python
-from anydi import Inject
+from anydi import Provide
 
 from app.container import container
 from app.services import GreetingService
 
 
-@container.inject
-def greet(service: GreetingService = Inject()) -> str:
+def greet(service: Provide[GreetingService]) -> str:
     return service.greet("World")
 
 
 if __name__ == "__main__":
-    print(greet())
+    print(container.run(greet))
 ```
 
 ### Test with Overrides (`tests/test_app.py`)
@@ -111,7 +110,7 @@ def test_greet() -> None:
     service_mock.greet.return_value = "Mocked"
 
     with container.override(GreetingService, service_mock):
-        result = greet()
+        result = container.run(greet)
 
     assert result == "Mocked"
 ```
@@ -123,8 +122,8 @@ from typing import Annotated
 
 import anydi.ext.fastapi
 from fastapi import FastAPI
-from anydi.ext.fastapi import Inject
 
+from anydi import Provide
 from app.container import container
 from app.services import GreetingService
 
@@ -134,7 +133,7 @@ app = FastAPI()
 
 @app.get("/greeting")
 async def greet(
-    service: Annotated[GreetingService, Inject()]
+    service: Provide[GreetingService]
 ) -> dict[str, str]:
     return {"greeting": service.greet("World")}
 
@@ -210,7 +209,7 @@ Wire Django Ninja (`urls.py`):
 ```python
 from typing import Annotated, Any
 
-from anydi import Inject
+from anydi import Provide
 from django.http import HttpRequest
 from django.urls import path
 from ninja import NinjaAPI
@@ -222,7 +221,7 @@ api = NinjaAPI()
 
 
 @api.get("/greeting")
-def greet(request: HttpRequest, service: Annotated[GreetingService, Inject()]) -> Any:
+def greet(request: HttpRequest, service: Provide[GreetingService]) -> Any:
     return {"greeting": service.greet("World")}
 
 
@@ -230,3 +229,23 @@ urlpatterns = [
     path("api/", api.urls),
 ]
 ```
+
+## What's Next?
+
+Ready to learn more? Check out these resources:
+
+**Core Documentation:**
+- [Core Concepts](https://anydi.readthedocs.io/en/latest/concepts/) - Understand containers, providers, scopes, and dependency injection
+- [Providers](https://anydi.readthedocs.io/en/latest/usage/providers/) - Learn about registration, named providers, and resource management
+- [Scopes](https://anydi.readthedocs.io/en/latest/usage/scopes/) - Master lifecycle management with built-in and custom scopes
+- [Dependency Injection](https://anydi.readthedocs.io/en/latest/usage/injection/) - Explore injection patterns and techniques
+- [Testing](https://anydi.readthedocs.io/en/latest/usage/testing/) - Write testable code with provider overrides
+
+**Framework Integrations:**
+- [FastAPI](https://anydi.readthedocs.io/en/latest/extensions/fastapi/) - Build modern APIs with automatic dependency injection
+- [Django](https://anydi.readthedocs.io/en/latest/extensions/django/) - Integrate with Django and Django Ninja
+- [FastStream](https://anydi.readthedocs.io/en/latest/extensions/faststream/) - Message broker applications
+- [Pydantic Settings](https://anydi.readthedocs.io/en/latest/extensions/pydantic_settings/) - Configuration management
+
+**Full Documentation:**
+- [Read the Docs](https://anydi.readthedocs.io/) - Complete documentation with examples and guides

{anydi-0.56.0 → anydi-0.58.0}/anydi/__init__.py

@@ -1,10 +1,10 @@
 """AnyDI public objects and functions."""
 
-from ._container import Container
+from ._container import Container, import_container
 from ._decorators import injectable, provided, provider, request, singleton, transient
 from ._module import Module
 from ._provider import ProviderDef as Provider
-from ._types import Inject, Scope
+from ._types import Inject, Provide, Scope
 
 # Alias for dependency auto marker
 # TODO: deprecate it
@@ -15,9 +15,11 @@ __all__ = [
     "Container",
     "Inject",
     "Module",
+    "Provide",
     "Provider",
     "Scope",
     "auto",
+    "import_container",
     "injectable",
     "provided",
     "provider",