anydi 0.22.1__py3-none-any.whl → 0.37.4__py3-none-any.whl

{anydi-0.22.1.dist-info → anydi-0.37.4.dist-info}/METADATA

@@ -1,13 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: anydi
-Version: 0.22.1
+Version: 0.37.4
 Summary: Dependency Injection library
-Home-page: https://github.com/antonrh/anydi
-License: MIT
-Keywords: dependency injection,dependencies,di,async,asyncio,application
-Author: Anton Ruhlov
-Author-email: antonruhlov@gmail.com
-Requires-Python: >=3.8,<4.0
+Project-URL: Repository, https://github.com/antonrh/anydi
+Author-email: Anton Ruhlov <antonruhlov@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: application,async,asyncio,dependencies,dependency injection,di
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Web Environment
 Classifier: Intended Audience :: Developers
@@ -16,26 +15,22 @@ Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Internet
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Provides-Extra: async
-Provides-Extra: docs
-Requires-Dist: anyio (>=3.6.2,<4.0.0) ; extra == "async"
-Requires-Dist: mkdocs (>=1.4.2,<2.0.0) ; extra == "docs"
-Requires-Dist: mkdocs-material (>=9.1.13,<10.0.0) ; extra == "docs"
-Requires-Dist: typing-extensions (>=4.8.0,<5.0.0)
-Project-URL: Repository, https://github.com/antonrh/anydi
+Requires-Python: ~=3.9
+Requires-Dist: anyio>=3.7.1
+Requires-Dist: typing-extensions<5,>=4.12.1
+Requires-Dist: wrapt<2,>=1.17.0
 Description-Content-Type: text/markdown
 
 # AnyDI
@@ -63,7 +58,7 @@ http://anydi.readthedocs.io/
 
 ---
 
-`AnyDI` is a modern, lightweight Dependency Injection library suitable for any synchronous or asynchronous applications with Python 3.8+, based on type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
+`AnyDI` is a modern, lightweight Dependency Injection library suitable for any synchronous or asynchronous applications with Python 3.9+, based on type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
 
 The key features are:
 
@@ -89,7 +84,7 @@ pip install anydi
 *app.py*
 
 ```python
-from anydi import Container, dep
+from anydi import auto, Container
 
 container = Container()
 
@@ -100,7 +95,7 @@ def message() -> str:
 
 
 @container.inject
-def say_hello(message: str = dep()) -> None:
+def say_hello(message: str = auto) -> None:
     print(message)
 
 
@@ -139,3 +134,58 @@ 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.37.4.dist-info/RECORD

@@ -0,0 +1,29 @@
+anydi/__init__.py,sha256=OfRg2EfXD65pHTGQKhfkABMwUhw5LvsuTQV_Tv4V4wk,501
+anydi/_container.py,sha256=yH1DsSQFkbfxGaDFs47nr-iXLE_Wwgv6QMTGWrRb8cE,38524
+anydi/_context.py,sha256=7LV_SL4QWkJeiG7_4D9PZ5lmU-MPzhofxC95zCgY9Gc,2651
+anydi/_provider.py,sha256=1IyxHO83NHjsPDHLDIZtW1pJ7i8VpWD3EM4T6duw9zA,7661
+anydi/_types.py,sha256=fdO4xNXtGMxVArmlfDkFYbyR895ixkBTW6V8lMceN7Q,1562
+anydi/_utils.py,sha256=INI0jNIXrJ6LS4zqJymMO2yUEobpxmBGASf4G_vR6AU,4378
+anydi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anydi/ext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anydi/ext/_utils.py,sha256=U6sRqWzccWUu7eMhbXX1NrwcaxitQF9cO1KxnKF37gw,2566
+anydi/ext/fastapi.py,sha256=AEL3ubu-LxUPHMMt1YIn3En_JZC7nyBKmKxmhka3O3c,2436
+anydi/ext/faststream.py,sha256=qXnNGvAqWWp9kbhbQUE6EF_OPUiYQmtOH211_O7BI_0,1898
+anydi/ext/pydantic_settings.py,sha256=8IXXLuG_OvKbvKlBkBRQUHcXgbTpgQUxeWyoMcRIUQM,1488
+anydi/ext/pytest_plugin.py,sha256=ShGhiZnP1KyMHhnc9Ci1RKAuHVhw628OTS2P2BLEOfc,5001
+anydi/ext/django/__init__.py,sha256=QI1IABCVgSDTUoh7M9WMECKXwB3xvh04HfQ9TOWw1Mk,223
+anydi/ext/django/_container.py,sha256=cxVoYQG16WP0S_Yv4TnLwuaaT7NVEOhLWO-YdALJUb4,418
+anydi/ext/django/_settings.py,sha256=Z0RlAuXoO73oahWeMkK10w8c-4uCBde-DBpeKTV5USY,853
+anydi/ext/django/_utils.py,sha256=q6X6GApBm0oBK8DnoRZhTq2m4tAdKRYL__gVgKn3idg,3977
+anydi/ext/django/apps.py,sha256=mjbf_mDCpNSriGnILzhRIr8wFHLMEK8sUerbmRku6i0,2844
+anydi/ext/django/middleware.py,sha256=5OUdp0OWRozyW338Sq04BDhacaFlyUTTOduS_7EwCTA,854
+anydi/ext/django/ninja/__init__.py,sha256=kW3grUgWp_nkWSG_-39ADHMrZLGNcj9TsJ9OW8iWWrk,546
+anydi/ext/django/ninja/_operation.py,sha256=wSWa7D73XTVlOibmOciv2l6JHPe1ERZcXrqI8W-oO2w,2696
+anydi/ext/django/ninja/_signature.py,sha256=2cSzKxBIxXLqtwNuH6GSlmjVJFftoGmleWfyk_NVEWw,2207
+anydi/ext/starlette/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anydi/ext/starlette/middleware.py,sha256=9CQtGg5ZzUz2gFSzJr8U4BWzwNjK8XMctm3n52M77Z0,792
+anydi-0.37.4.dist-info/METADATA,sha256=LzSi277vUt7DJCFHnycYjlLGKaLM60uf6pJX-VZQZzs,4917
+anydi-0.37.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+anydi-0.37.4.dist-info/entry_points.txt,sha256=Nklo9f3Oe4AkNsEgC4g43nCJ-23QDngZSVDNRMdaILI,43
+anydi-0.37.4.dist-info/licenses/LICENSE,sha256=V6rU8a8fv6o2jQ-7ODHs0XfDFimot8Q6Km6CylRIDTo,1069
+anydi-0.37.4.dist-info/RECORD,,

{anydi-0.22.1.dist-info → anydi-0.37.4.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.8.1
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any

anydi-0.37.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[pytest11]
+anydi = anydi.ext.pytest_plugin

anydi/_logger.py

@@ -1,3 +0,0 @@
-import logging
-
-logger = logging.getLogger("anydi")

anydi/_module.py

@@ -1,124 +0,0 @@
-"""AnyDI decorators module."""
-
-from __future__ import annotations
-
-import inspect
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Tuple, Type, TypeVar, Union
-
-from typing_extensions import Concatenate, NamedTuple, ParamSpec
-
-from ._types import Scope
-
-if TYPE_CHECKING:
-    from ._container import Container
-
-T = TypeVar("T")
-M = TypeVar("M", bound="Module")
-P = ParamSpec("P")
-
-
-class ModuleMeta(type):
-    """A metaclass used for the Module base class.
-
-    This metaclass extracts provider information from the class attributes
-    and stores it in the `providers` attribute.
-    """
-
-    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
-        stores it in the `providers` attribute.
-
-        Args:
-            name: The name of the class.
-            bases: The base classes of the class.
-            attrs: The attributes of the class.
-
-        Returns:
-            The new instance of the class.
-        """
-        attrs["providers"] = [
-            (name, getattr(value, "__provider__"))
-            for name, value in attrs.items()
-            if hasattr(value, "__provider__")
-        ]
-        return super().__new__(cls, name, bases, attrs)
-
-
-class Module(metaclass=ModuleMeta):
-    """A base class for defining AnyDI modules."""
-
-    providers: List[Tuple[str, ProviderDecoratorArgs]]
-
-    def configure(self, container: Container) -> None:
-        """Configure the AnyDI container with providers and their dependencies.
-
-        This method can be overridden in derived classes to provide the
-        configuration logic.
-
-        Args:
-            container: The AnyDI container to be configured.
-        """
-
-
-class ModuleRegistry:
-    def __init__(self, container: Container) -> None:
-        self.container = container
-
-    def register(
-        self, module: Union[Module, Type[Module], Callable[[Container], None]]
-    ) -> None:
-        """Register a module as a callable, module type, or module instance.
-
-        Args:
-            module: The module to register.
-        """
-        # Callable Module
-        if inspect.isfunction(module):
-            module(self.container)
-            return
-
-        # Class based Module or Module type
-        if inspect.isclass(module) and issubclass(module, Module):
-            module = module()
-        if isinstance(module, Module):
-            module.configure(self.container)
-            for provider_name, decorator_args in module.providers:
-                obj = getattr(module, provider_name)
-                self.container.provider(
-                    scope=decorator_args.scope,
-                    override=decorator_args.override,
-                )(obj)
-
-
-class ProviderDecoratorArgs(NamedTuple):
-    scope: Scope
-    override: bool
-
-
-def provider(
-    *, scope: Scope, override: bool = False
-) -> Callable[[Callable[Concatenate[M, P], T]], Callable[Concatenate[M, P], T]]:
-    """Decorator for marking a function or method as a provider in a AnyDI module.
-
-    Args:
-        scope: The scope in which the provided instance should be managed.
-        override: Whether the provider should override existing providers
-            with the same interface.
-
-    Returns:
-        A decorator that marks the target function or method as a provider.
-    """
-
-    def decorator(
-        target: Callable[Concatenate[M, P], T],
-    ) -> Callable[Concatenate[M, P], T]:
-        setattr(
-            target,
-            "__provider__",
-            ProviderDecoratorArgs(scope=scope, override=override),
-        )
-        return target
-
-    return decorator

anydi/_scanner.py

@@ -1,233 +0,0 @@
-from __future__ import annotations
-
-import importlib
-import inspect
-import pkgutil
-from dataclasses import dataclass
-from types import ModuleType
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Iterable,
-    List,
-    Optional,
-    TypeVar,
-    Union,
-    cast,
-    final,
-    overload,
-)
-
-from typing_extensions import NamedTuple, ParamSpec
-
-from ._types import Marker
-from ._utils import get_signature
-
-if TYPE_CHECKING:
-    from ._container import Container
-
-
-T = TypeVar("T")
-P = ParamSpec("P")
-
-
-@dataclass(frozen=True)
-class Dependency:
-    """Represents a scanned dependency.
-
-    Attributes:
-        member: The member object that represents the dependency.
-        module: The module where the dependency is defined.
-    """
-
-    member: Any
-    module: ModuleType
-
-
-@final
-class Scanner:
-    """A class for scanning packages or modules for decorated objects
-    and injecting dependencies."""
-
-    def __init__(self, container: Container) -> None:
-        self.container = container
-
-    def scan(
-        self,
-        /,
-        packages: Union[Union[ModuleType, str], Iterable[Union[ModuleType, str]]],
-        *,
-        tags: Optional[Iterable[str]] = None,
-    ) -> None:
-        """Scan packages or modules for decorated members and inject dependencies.
-
-        Args:
-            packages: A single package or module to scan,
-                or an iterable of packages or modules to scan.
-            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] = []
-
-        if isinstance(packages, Iterable) and not isinstance(packages, str):
-            scan_packages: Iterable[Union[ModuleType, str]] = packages
-        else:
-            scan_packages = cast(Iterable[Union[ModuleType, str]], [packages])
-
-        for package in scan_packages:
-            dependencies.extend(self._scan_package(package, tags=tags))
-
-        for dependency in dependencies:
-            decorator = self.container.inject()(dependency.member)
-            setattr(dependency.module, dependency.member.__name__, decorator)
-
-    def _scan_package(
-        self,
-        package: Union[ModuleType, str],
-        *,
-        tags: Optional[Iterable[str]] = None,
-    ) -> List[Dependency]:
-        """Scan a package or module for decorated members.
-
-        Args:
-            package: The package or module to scan.
-            tags: Optional list of tags to filter the scanned members. Only members
-                with at least one matching tag will be scanned. Defaults to None.
-
-        Returns:
-            A list of scanned dependencies.
-        """
-        tags = tags or []
-        if isinstance(package, str):
-            package = importlib.import_module(package)
-
-        package_path = getattr(package, "__path__", None)
-
-        if not package_path:
-            return self._scan_module(package, tags=tags)
-
-        dependencies: List[Dependency] = []
-
-        for module_info in pkgutil.walk_packages(
-            path=package_path, prefix=package.__name__ + "."
-        ):
-            module = importlib.import_module(module_info.name)
-            dependencies.extend(self._scan_module(module, tags=tags))
-
-        return dependencies
-
-    def _scan_module(
-        self, module: ModuleType, *, tags: Iterable[str]
-    ) -> List[Dependency]:
-        """Scan a module for decorated members.
-
-        Args:
-            module: The module to scan.
-            tags: List of tags to filter the scanned members. Only members with at
-                least one matching tag will be scanned.
-
-        Returns:
-            A list of scanned dependencies.
-        """
-        dependencies: List[Dependency] = []
-
-        for _, member in inspect.getmembers(module):
-            if getattr(member, "__module__", None) != module.__name__ or not callable(
-                member
-            ):
-                continue
-
-            decorator_args: InjectDecoratorArgs = getattr(
-                member,
-                "__injectable__",
-                InjectDecoratorArgs(wrapped=False, tags=[]),
-            )
-
-            if tags and (
-                decorator_args.tags
-                and not set(decorator_args.tags).intersection(tags)
-                or not decorator_args.tags
-            ):
-                continue
-
-            if decorator_args.wrapped:
-                dependencies.append(
-                    self._create_dependency(member=member, module=module)
-                )
-                continue
-
-            # Get by Marker
-            if inspect.isclass(member):
-                signature = get_signature(member.__init__)
-            else:
-                signature = get_signature(member)
-            for parameter in signature.parameters.values():
-                if isinstance(parameter.default, Marker):
-                    dependencies.append(
-                        self._create_dependency(member=member, module=module)
-                    )
-                    continue
-
-        return dependencies
-
-    def _create_dependency(self, member: Any, module: ModuleType) -> Dependency:
-        """Create a `Dependency` object from the scanned member and module.
-
-        Args:
-            member: The scanned member.
-            module: The module containing the scanned member.
-
-        Returns:
-            A `ScannedDependency` object.
-        """
-        if hasattr(member, "__wrapped__"):
-            member = member.__wrapped__
-        return Dependency(member=member, module=module)
-
-
-class InjectDecoratorArgs(NamedTuple):
-    wrapped: bool
-    tags: Optional[Iterable[str]]
-
-
-@overload
-def injectable(obj: Callable[P, T]) -> Callable[P, T]: ...
-
-
-@overload
-def injectable(
-    *, tags: Optional[Iterable[str]] = 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],
-]:
-    """Decorator for marking a function or method as requiring dependency injection.
-
-    Args:
-        obj: The target function or method to be decorated.
-        tags: Optional tags to associate with the injection point.
-
-    Returns:
-        If `obj` is provided, returns the decorated target function or method.
-        If `obj` is not provided, returns a decorator that can be used to mark
-        a function or method as requiring dependency injection.
-    """
-
-    def decorator(obj: Callable[P, T]) -> Callable[P, T]:
-        setattr(obj, "__injectable__", InjectDecoratorArgs(wrapped=True, tags=tags))
-        return obj
-
-    if obj is None:
-        return decorator
-
-    return decorator(obj)

anydi-0.22.1.dist-info/RECORD

@@ -1,20 +0,0 @@
-anydi/__init__.py,sha256=p2GQq45mulZRlC8oJ7bvOpjVFCeycsgI2IcNJjs_LhU,562
-anydi/_container.py,sha256=1mUCynjqgcQVIC1oSZUszfzxW4jvlaQofULoFcJFZiQ,28219
-anydi/_context.py,sha256=btGJzvTMkj5v95rAw6kjOclISKcSugC4wzrHlWlCk_I,10258
-anydi/_logger.py,sha256=UpubJUnW83kffFxkhUlObm2DmZX1Pjqoz9YFKS-JOPg,52
-anydi/_module.py,sha256=1fBo9-RWxo7TeyP0Y2uJokT-NXP2pjik6CXNoeo3l-8,3712
-anydi/_scanner.py,sha256=YYPqzAQRgxxMpOSOpE7EqA_hccC6VjKi9Y8y_5HbtlA,6781
-anydi/_types.py,sha256=AuHR2hvqaMazL55xj8I9YI6nyBAD16uQznNcmZoQsPE,3240
-anydi/_utils.py,sha256=haRwC6YTTFf6CNTfwsRQ4NZsNByoUkEmE4-rh1-VYLs,3152
-anydi/ext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-anydi/ext/_utils.py,sha256=upgkXFs3EKYRHX9NktOzuJDPVDglCjdb3B593V-LcU8,1949
-anydi/ext/fastapi.py,sha256=QET3UQLSR2ZNirRuZp1o6eaetJG9yjsFvOuNwTil3Jw,2859
-anydi/ext/pytest_plugin.py,sha256=ste4ItDodvGsvkADShWdEhZapxlRG3vG-S4dmkfP7-I,4028
-anydi/ext/starlette/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-anydi/ext/starlette/middleware.py,sha256=Ni0BQaPjs_Ha6zcLZYYJ3-XkslTCnL9aCSa06rnRDMI,1139
-anydi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-anydi-0.22.1.dist-info/LICENSE,sha256=V6rU8a8fv6o2jQ-7ODHs0XfDFimot8Q6Km6CylRIDTo,1069
-anydi-0.22.1.dist-info/METADATA,sha256=4duWnwgK4IWCqLkvqGFeRBK-8JgdylC1aEK80p7PpmA,4371
-anydi-0.22.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-anydi-0.22.1.dist-info/entry_points.txt,sha256=GmQblwzxFg42zva1HyBYJJ7TvrTIcSAGBHmyi3bvsi4,42
-anydi-0.22.1.dist-info/RECORD,,

anydi-0.22.1.dist-info/entry_points.txt

@@ -1,3 +0,0 @@
-[pytest11]
-anydi=anydi.ext.pytest_plugin
-