anydi 0.25.0a1__tar.gz → 0.25.0a2__tar.gz

{anydi-0.25.0a1 → anydi-0.25.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: anydi
-Version: 0.25.0a1
+Version: 0.25.0a2
 Summary: Dependency Injection library
 Home-page: https://github.com/antonrh/anydi
 License: MIT
@@ -139,3 +139,59 @@ def say_hello(message: str = Inject()) -> dict[str, str]:
 anydi.ext.fastapi.install(app, container)
 ```
 
+
+
+## Django Ninja Example
+
+*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.ext.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.25.0a1 → anydi-0.25.0a2}/README.md

@@ -98,3 +98,59 @@ def say_hello(message: str = Inject()) -> dict[str, str]:
 # Install the container into the FastAPI app
 anydi.ext.fastapi.install(app, container)
 ```
+
+
+
+## Django Ninja Example
+
+*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.ext.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.25.0a1 → anydi-0.25.0a2}/anydi/_container.py

@@ -15,21 +15,16 @@ from typing import (
     Awaitable,
     Callable,
     ContextManager,
-    Dict,
     Iterable,
     Iterator,
-    List,
     Mapping,
-    Optional,
     Sequence,
-    Type,
     TypeVar,
-    Union,
     cast,
     overload,
 )
 
-from typing_extensions import Annotated, ParamSpec, final, get_args, get_origin
+from typing_extensions import ParamSpec, final, get_args, get_origin
 
 try:
     from types import NoneType
@@ -48,12 +43,17 @@ from ._logger import logger
 from ._module import Module, ModuleRegistry
 from ._scanner import Scanner
 from ._types import AnyInterface, Interface, Provider, Scope, is_marker
-from ._utils import get_full_qualname, get_signature, is_builtin_type
+from ._utils import (
+    get_full_qualname,
+    get_typed_parameters,
+    get_typed_return_annotation,
+    is_builtin_type,
+)
 
 T = TypeVar("T", bound=Any)
 P = ParamSpec("P")
 
-ALLOWED_SCOPES: Dict[Scope, List[Scope]] = {
+ALLOWED_SCOPES: dict[Scope, list[Scope]] = {
     "singleton": ["singleton"],
     "request": ["request", "singleton"],
     "transient": ["transient", "singleton", "request"],
@@ -71,10 +71,9 @@ class Container:
     def __init__(
         self,
         *,
-        providers: Optional[Mapping[Type[Any], Provider]] = None,
-        modules: Optional[
-            Sequence[Union[Module, Type[Module], Callable[[Container], None]]]
-        ] = None,
+        providers: Mapping[type[Any], Provider] | None = None,
+        modules: Sequence[Module | type[Module] | Callable[[Container], None]]
+        | None = None,
         strict: bool = False,
     ) -> None:
         """Initialize the AnyDI instance.
@@ -84,13 +83,13 @@ class Container:
             modules: Optional sequence of modules to register during initialization.
             strict: Whether to enable strict mode. Defaults to False.
         """
-        self._providers: Dict[Type[Any], Provider] = {}
+        self._providers: dict[type[Any], Provider] = {}
         self._singleton_context = SingletonContext(self)
         self._transient_context = TransientContext(self)
-        self._request_context_var: ContextVar[Optional[RequestContext]] = ContextVar(
+        self._request_context_var: ContextVar[RequestContext | None] = ContextVar(
             "request_context", default=None
         )
-        self._override_instances: Dict[Type[Any], Any] = {}
+        self._override_instances: dict[type[Any], Any] = {}
         self._strict = strict
 
         # Components
@@ -117,7 +116,7 @@ class Container:
         return self._strict
 
     @property
-    def providers(self) -> Dict[Type[Any], Provider]:
+    def providers(self) -> dict[type[Any], Provider]:
         """Get the registered providers.
 
         Returns:
@@ -333,7 +332,7 @@ class Container:
         """
         related_providers = []
 
-        for parameter in provider.parameters.values():
+        for parameter in provider.parameters:
             if parameter.annotation is inspect._empty:  # noqa
                 raise TypeError(
                     f"Missing provider `{provider}` "
@@ -363,7 +362,7 @@ class Container:
                     "registered with matching scopes."
                 )
 
-    def _detect_scope(self, obj: Callable[..., Any]) -> Optional[Scope]:
+    def _detect_scope(self, obj: Callable[..., Any]) -> Scope | None:
         """Detect the scope for a provider.
 
         Args:
@@ -372,7 +371,7 @@ class Container:
             The auto scope, or None if the auto scope cannot be detected.
         """
         has_transient, has_request, has_singleton = False, False, False
-        for parameter in get_signature(obj).parameters.values():
+        for parameter in get_typed_parameters(obj):
             sub_provider = self._get_or_register_provider(parameter.annotation)
             if not has_transient and sub_provider.scope == "transient":
                 has_transient = True
@@ -389,7 +388,7 @@ class Container:
         return None
 
     def register_module(
-        self, module: Union[Module, Type[Module], Callable[[Container], None]]
+        self, module: Module | type[Module] | Callable[[Container], None]
     ) -> None:
         """Register a module as a callable, module type, or module instance.
 
@@ -633,14 +632,11 @@ class Container:
     def inject(self) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
 
     def inject(
-        self, obj: Union[Callable[P, Union[T, Awaitable[T]]], None] = None
-    ) -> Union[
-        Callable[
-            [Callable[P, Union[T, Awaitable[T]]]],
-            Callable[P, Union[T, Awaitable[T]]],
-        ],
-        Callable[P, Union[T, Awaitable[T]]],
-    ]:
+        self, obj: Callable[P, T | Awaitable[T]] | None = None
+    ) -> (
+        Callable[[Callable[P, T | Awaitable[T]]], Callable[P, T | Awaitable[T]]]
+        | Callable[P, T | Awaitable[T]]
+    ):
         """Decorator to inject dependencies into a callable.
 
         Args:
@@ -652,8 +648,8 @@ class Container:
         """
 
         def decorator(
-            obj: Callable[P, Union[T, Awaitable[T]]],
-        ) -> Callable[P, Union[T, Awaitable[T]]]:
+            obj: Callable[P, T | Awaitable[T]],
+        ) -> Callable[P, T | Awaitable[T]]:
             injected_params = self._get_injected_params(obj)
 
             if inspect.iscoroutinefunction(obj):
@@ -694,12 +690,9 @@ class Container:
     def scan(
         self,
         /,
-        packages: Union[
-            Union[types.ModuleType, str],
-            Iterable[Union[types.ModuleType, str]],
-        ],
+        packages: types.ModuleType | str | Iterable[types.ModuleType | str],
         *,
-        tags: Optional[Iterable[str]] = None,
+        tags: Iterable[str] | None = None,
     ) -> None:
         """Scan packages or modules for decorated members and inject dependencies.
 
@@ -723,32 +716,26 @@ class Container:
         Raises:
             TypeError: If the provider return annotation is missing or invalid.
         """
-        annotation = get_signature(obj).return_annotation
+        annotation = get_typed_return_annotation(obj)
 
-        if annotation is inspect._empty:  # noqa
+        if annotation is None:
             raise TypeError(
                 f"Missing `{get_full_qualname(obj)}` provider return annotation."
             )
 
-        origin = get_origin(annotation) or annotation
-        args = get_args(annotation)
-
-        # Supported generic types
-        if origin in (list, dict, tuple, Annotated):
+        if get_origin(annotation) in (get_origin(Iterator), get_origin(AsyncIterator)):
+            args = get_args(annotation)
             if args:
-                return annotation
+                return args[0]
             else:
                 raise TypeError(
-                    f"Cannot use `{get_full_qualname(obj)}` generic type annotation "
+                    f"Cannot use `{get_full_qualname(obj)}` resource type annotation "
                     "without actual type."
                 )
 
-        try:
-            return args[0]
-        except IndexError:
-            return annotation
+        return annotation
 
-    def _get_injected_params(self, obj: Callable[..., Any]) -> Dict[str, Any]:
+    def _get_injected_params(self, obj: Callable[..., Any]) -> dict[str, Any]:
         """Get the injected parameters of a callable object.
 
         Args:
@@ -759,7 +746,7 @@ class Container:
                 of the injected parameters.
         """
         injected_params = {}
-        for parameter in get_signature(obj).parameters.values():
+        for parameter in get_typed_parameters(obj):
             if not is_marker(parameter.default):
                 continue
             try:

{anydi-0.25.0a1 → anydi-0.25.0a2}/anydi/_context.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import abc
 import contextlib
 from types import TracebackType
-from typing import TYPE_CHECKING, Any, Dict, List, Tuple, Type, TypeVar, cast
+from typing import TYPE_CHECKING, Any, TypeVar, cast
 
 from typing_extensions import Self, final
 
@@ -87,7 +87,7 @@ class ScopedContext(abc.ABC):
 
     def _get_provider_arguments(
         self, provider: Provider
-    ) -> Tuple[List[Any], Dict[str, Any]]:
+    ) -> tuple[list[Any], dict[str, Any]]:
         """Retrieve the arguments for a provider.
 
         Args:
@@ -97,7 +97,7 @@ class ScopedContext(abc.ABC):
             The arguments for the provider.
         """
         args, kwargs = [], {}
-        for parameter in provider.parameters.values():
+        for parameter in provider.parameters:
             instance = self.container.resolve(parameter.annotation)
             if parameter.kind == parameter.POSITIONAL_ONLY:
                 args.append(instance)
@@ -107,7 +107,7 @@ class ScopedContext(abc.ABC):
 
     async def _aget_provider_arguments(
         self, provider: Provider
-    ) -> Tuple[List[Any], Dict[str, Any]]:
+    ) -> tuple[list[Any], dict[str, Any]]:
         """Asynchronously retrieve the arguments for a provider.
 
         Args:
@@ -117,7 +117,7 @@ class ScopedContext(abc.ABC):
             The arguments for the provider.
         """
         args, kwargs = [], {}
-        for parameter in provider.parameters.values():
+        for parameter in provider.parameters:
             instance = await self.container.aresolve(parameter.annotation)
             if parameter.kind == parameter.POSITIONAL_ONLY:
                 args.append(instance)
@@ -132,7 +132,7 @@ class ResourceScopedContext(ScopedContext):
     def __init__(self, container: Container) -> None:
         """Initialize the ScopedContext."""
         super().__init__(container)
-        self._instances: Dict[Type[Any], Any] = {}
+        self._instances: dict[type[Any], Any] = {}
         self._stack = contextlib.ExitStack()
         self._async_stack = contextlib.AsyncExitStack()
 
@@ -237,7 +237,7 @@ class ResourceScopedContext(ScopedContext):
 
     def __exit__(
         self,
-        exc_type: Type[BaseException] | None,
+        exc_type: type[BaseException] | None,
         exc_val: BaseException | None,
         exc_tb: TracebackType | None,
     ) -> None:
@@ -265,7 +265,7 @@ class ResourceScopedContext(ScopedContext):
 
     async def __aexit__(
         self,
-        exc_type: Type[BaseException] | None,
+        exc_type: type[BaseException] | None,
         exc_val: BaseException | None,
         exc_tb: TracebackType | None,
     ) -> None:

{anydi-0.25.0a1 → anydi-0.25.0a2}/anydi/_module.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 import inspect
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Tuple, Type, TypeVar, Union
+from typing import TYPE_CHECKING, Any, Callable, TypeVar
 
 from typing_extensions import Concatenate, NamedTuple, ParamSpec
 
@@ -24,7 +24,7 @@ class ModuleMeta(type):
     and stores it in the `providers` attribute.
     """
 
-    def __new__(cls, name: str, bases: Tuple[type, ...], attrs: Dict[str, Any]) -> Any:
+    def __new__(cls, name: str, bases: tuple[type, ...], attrs: dict[str, Any]) -> Any:
         """Create a new instance of the ModuleMeta class.
 
         This method extracts provider information from the class attributes and
@@ -49,7 +49,7 @@ class ModuleMeta(type):
 class Module(metaclass=ModuleMeta):
     """A base class for defining AnyDI modules."""
 
-    providers: List[Tuple[str, ProviderDecoratorArgs]]
+    providers: list[tuple[str, ProviderDecoratorArgs]]
 
     def configure(self, container: Container) -> None:
         """Configure the AnyDI container with providers and their dependencies.
@@ -67,7 +67,7 @@ class ModuleRegistry:
         self.container = container
 
     def register(
-        self, module: Union[Module, Type[Module], Callable[[Container], None]]
+        self, module: Module | type[Module] | Callable[[Container], None]
     ) -> None:
         """Register a module as a callable, module type, or module instance.
 

{anydi-0.25.0a1 → anydi-0.25.0a2}/anydi/_scanner.py

@@ -10,8 +10,6 @@ from typing import (
     Any,
     Callable,
     Iterable,
-    List,
-    Optional,
     TypeVar,
     Union,
     cast,
@@ -22,7 +20,7 @@ from typing import (
 from typing_extensions import NamedTuple, ParamSpec
 
 from ._types import is_marker
-from ._utils import get_signature
+from ._utils import get_typed_parameters
 
 if TYPE_CHECKING:
     from ._container import Container
@@ -56,9 +54,9 @@ class Scanner:
     def scan(
         self,
         /,
-        packages: Union[Union[ModuleType, str], Iterable[Union[ModuleType, str]]],
+        packages: ModuleType | str | Iterable[ModuleType | str],
         *,
-        tags: Optional[Iterable[str]] = None,
+        tags: Iterable[str] | None = None,
     ) -> None:
         """Scan packages or modules for decorated members and inject dependencies.
 
@@ -68,10 +66,10 @@ class Scanner:
             tags: Optional list of tags to filter the scanned members. Only members
                 with at least one matching tag will be scanned. Defaults to None.
         """
-        dependencies: List[Dependency] = []
+        dependencies: list[Dependency] = []
 
         if isinstance(packages, Iterable) and not isinstance(packages, str):
-            scan_packages: Iterable[Union[ModuleType, str]] = packages
+            scan_packages: Iterable[ModuleType | str] = packages
         else:
             scan_packages = cast(Iterable[Union[ModuleType, str]], [packages])
 
@@ -84,10 +82,10 @@ class Scanner:
 
     def _scan_package(
         self,
-        package: Union[ModuleType, str],
+        package: ModuleType | str,
         *,
-        tags: Optional[Iterable[str]] = None,
-    ) -> List[Dependency]:
+        tags: Iterable[str] | None = None,
+    ) -> list[Dependency]:
         """Scan a package or module for decorated members.
 
         Args:
@@ -107,7 +105,7 @@ class Scanner:
         if not package_path:
             return self._scan_module(package, tags=tags)
 
-        dependencies: List[Dependency] = []
+        dependencies: list[Dependency] = []
 
         for module_info in pkgutil.walk_packages(
             path=package_path, prefix=package.__name__ + "."
@@ -119,7 +117,7 @@ class Scanner:
 
     def _scan_module(
         self, module: ModuleType, *, tags: Iterable[str]
-    ) -> List[Dependency]:
+    ) -> list[Dependency]:
         """Scan a module for decorated members.
 
         Args:
@@ -130,7 +128,7 @@ class Scanner:
         Returns:
             A list of scanned dependencies.
         """
-        dependencies: List[Dependency] = []
+        dependencies: list[Dependency] = []
 
         for _, member in inspect.getmembers(module):
             if getattr(member, "__module__", None) != module.__name__ or not callable(
@@ -159,10 +157,10 @@ class Scanner:
 
             # Get by Marker
             if inspect.isclass(member):
-                signature = get_signature(member.__init__)
+                parameters = get_typed_parameters(member.__init__)
             else:
-                signature = get_signature(member)
-            for parameter in signature.parameters.values():
+                parameters = get_typed_parameters(member)
+            for parameter in parameters:
                 if is_marker(parameter.default):
                     dependencies.append(
                         self._create_dependency(member=member, module=module)
@@ -188,7 +186,7 @@ class Scanner:
 
 class InjectDecoratorArgs(NamedTuple):
     wrapped: bool
-    tags: Optional[Iterable[str]]
+    tags: Iterable[str] | None
 
 
 @overload
@@ -197,20 +195,14 @@ def injectable(obj: Callable[P, T]) -> Callable[P, T]: ...
 
 @overload
 def injectable(
-    *, tags: Optional[Iterable[str]] = None
+    *, tags: Iterable[str] | None = None
 ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
 
 
 def injectable(
-    obj: Optional[Callable[P, T]] = None,
-    tags: Optional[Iterable[str]] = None,
-) -> Union[
-    Callable[
-        [Callable[P, T]],
-        Callable[P, T],
-    ],
-    Callable[P, T],
-]:
+    obj: Callable[P, T] | None = None,
+    tags: Iterable[str] | None = None,
+) -> Callable[[Callable[P, T]], Callable[P, T]] | Callable[P, T]:
     """Decorator for marking a function or method as requiring dependency injection.
 
     Args:

{anydi-0.25.0a1 → anydi-0.25.0a2}/anydi/_types.py

@@ -1,11 +1,13 @@
+from __future__ import annotations
+
 import inspect
 from dataclasses import dataclass
 from functools import cached_property
 from typing import Any, Callable, Type, TypeVar, Union
 
-from typing_extensions import Annotated, Literal, Mapping, Self, TypeAlias
+from typing_extensions import Annotated, Literal, Self, TypeAlias
 
-from ._utils import get_full_qualname, get_signature
+from ._utils import get_full_qualname, get_typed_parameters
 
 Scope = Literal["transient", "singleton", "request"]
 
@@ -58,13 +60,13 @@ class Provider:
         return get_full_qualname(self.obj)
 
     @cached_property
-    def parameters(self) -> Mapping[str, inspect.Parameter]:
+    def parameters(self) -> list[inspect.Parameter]:
         """Returns the parameters of the provider as a mapping.
 
         Returns:
             The parameters of the provider.
         """
-        return get_signature(self.obj).parameters
+        return get_typed_parameters(self.obj)
 
     @cached_property
     def is_class(self) -> bool: