python-injection 0.17.3.post0__tar.gz → 0.18.0.post0__tar.gz

{python_injection-0.17.3.post0 → python_injection-0.18.0.post0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.17.3.post0
+Version: 0.18.0.post0
 Summary: Fast and easy dependency injection framework.
 Project-URL: Repository, https://github.com/100nm/python-injection
 Author: remimd
@@ -87,6 +87,7 @@ if __name__ == "__main__":
 * [**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)
-* [**Utils**](https://github.com/100nm/python-injection/tree/prod/documentation/utils.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.md)
 * [**Concrete example**](https://github.com/100nm/python-injection-example)

{python_injection-0.17.3.post0 → python_injection-0.18.0.post0}/README.md

@@ -62,6 +62,7 @@ if __name__ == "__main__":
 * [**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)
-* [**Utils**](https://github.com/100nm/python-injection/tree/prod/documentation/utils.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.md)
 * [**Concrete example**](https://github.com/100nm/python-injection-example)

python_injection-0.18.0.post0/injection/entrypoint.py

@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+import asyncio
+from collections.abc import AsyncIterator, Awaitable, Callable, Coroutine, Iterator
+from contextlib import asynccontextmanager, contextmanager
+from dataclasses import dataclass, field
+from functools import wraps
+from types import MethodType
+from types import ModuleType as PythonModule
+from typing import Any, Self, final, overload
+
+from injection import Module, mod
+from injection.loaders import PythonModuleLoader
+
+__all__ = ("AsyncEntrypoint", "Entrypoint", "autocall", "entrypointmaker")
+
+type AsyncEntrypoint[**P, T] = Entrypoint[P, Coroutine[Any, Any, T]]
+type EntrypointDecorator[**P, T1, T2] = Callable[[Callable[P, T1]], Callable[P, T2]]
+type EntrypointSetupMethod[*Ts, **P, T1, T2] = Callable[
+    [Entrypoint[P, T1], *Ts],
+    Entrypoint[P, T2],
+]
+
+
+def autocall[**P, T](wrapped: Callable[P, T] | None = None, /) -> Any:
+    def decorator(wp: Callable[P, T]) -> Callable[P, T]:
+        wp()  # type: ignore[call-arg]
+        return wp
+
+    return decorator(wrapped) if wrapped else decorator
+
+
+@overload
+def entrypointmaker[*Ts, **P, T1, T2](
+    wrapped: EntrypointSetupMethod[*Ts, P, T1, T2],
+    /,
+    *,
+    module: Module = ...,
+) -> EntrypointDecorator[P, T1, T2]: ...
+
+
+@overload
+def entrypointmaker[*Ts, **P, T1, T2](
+    wrapped: None = ...,
+    /,
+    *,
+    module: Module = ...,
+) -> Callable[
+    [EntrypointSetupMethod[*Ts, P, T1, T2]],
+    EntrypointDecorator[P, T1, T2],
+]: ...
+
+
+def entrypointmaker[*Ts, **P, T1, T2](
+    wrapped: EntrypointSetupMethod[*Ts, P, T1, T2] | None = None,
+    /,
+    *,
+    module: Module | None = None,
+) -> Any:
+    def decorator(
+        wp: EntrypointSetupMethod[*Ts, P, T1, T2],
+    ) -> EntrypointDecorator[P, T1, T2]:
+        return Entrypoint._make_decorator(wp, module)
+
+    return decorator(wrapped) if wrapped else decorator
+
+
+@final
+@dataclass(repr=False, eq=False, frozen=True, slots=True)
+class Entrypoint[**P, T]:
+    function: Callable[P, T]
+    module: Module = field(default_factory=mod)
+
+    def __call__(self, /, *args: P.args, **kwargs: P.kwargs) -> T:
+        return self.function(*args, **kwargs)
+
+    def async_to_sync[_T](
+        self: AsyncEntrypoint[P, _T],
+        run: Callable[[Coroutine[Any, Any, _T]], _T] = asyncio.run,
+        /,
+    ) -> Entrypoint[P, _T]:
+        function = self.function
+
+        @wraps(function)
+        def wrapper(*args: P.args, **kwargs: P.kwargs) -> _T:
+            return run(function(*args, **kwargs))
+
+        return self.__recreate(wrapper)
+
+    def decorate(
+        self,
+        decorator: Callable[[Callable[P, T]], Callable[P, T]],
+        /,
+    ) -> Self:
+        return self.__recreate(decorator(self.function))
+
+    def inject(self) -> Self:
+        return self.decorate(self.module.make_injected_function)
+
+    def load_modules(
+        self,
+        /,
+        loader: PythonModuleLoader,
+        *packages: PythonModule | str,
+    ) -> Self:
+        return self.setup(lambda: loader.load(*packages))
+
+    def setup(self, function: Callable[..., Any], /) -> Self:
+        @contextmanager
+        def decorator() -> Iterator[Any]:
+            yield function()
+
+        return self.decorate(decorator())
+
+    def async_setup[_T](
+        self: AsyncEntrypoint[P, _T],
+        function: Callable[..., Awaitable[Any]],
+        /,
+    ) -> AsyncEntrypoint[P, _T]:
+        @asynccontextmanager
+        async def decorator() -> AsyncIterator[Any]:
+            yield await function()
+
+        return self.decorate(decorator())
+
+    def __recreate[**_P, _T](
+        self: Entrypoint[Any, Any],
+        function: Callable[_P, _T],
+        /,
+    ) -> Entrypoint[_P, _T]:
+        return type(self)(function, self.module)
+
+    @classmethod
+    def _make_decorator[*Ts, _T](
+        cls,
+        setup_method: EntrypointSetupMethod[*Ts, P, T, _T],
+        /,
+        module: Module | None = None,
+    ) -> EntrypointDecorator[P, T, _T]:
+        module = module or mod()
+        setup_method = module.make_injected_function(setup_method)
+
+        def decorator(function: Callable[P, T]) -> Callable[P, _T]:
+            self = cls(function, module)
+            return MethodType(setup_method, self)().function
+
+        return decorator

{python_injection-0.17.3.post0 → python_injection-0.18.0.post0}/injection/loaders.py

@@ -57,7 +57,7 @@ class PythonModuleLoader:
 
     def load(self, *packages: PythonModule | str) -> Self:
         modules = itertools.chain.from_iterable(
-            self.__iter_modules(package) for package in packages
+            self.__iter_modules_from(package) for package in packages
         )
         self.__modules.update(modules)
         return self
@@ -67,7 +67,7 @@ class PythonModuleLoader:
             module_name in modules for modules in (self.__modules, self._sys_modules)
         )
 
-    def __iter_modules(
+    def __iter_modules_from(
         self,
         package: PythonModule | str,
     ) -> Iterator[tuple[str, PythonModule | None]]:

{python_injection-0.17.3.post0 → python_injection-0.18.0.post0}/pyproject.toml

@@ -13,6 +13,11 @@ dev = [
     "mypy",
     "ruff",
 ]
+doc = [
+    "fastapi",
+    "typer",
+    "uvloop",
+]
 test = [
     "fastapi",
     "httpx",
@@ -24,7 +29,7 @@ test = [
 
 [project]
 name = "python-injection"
-version = "0.17.3.post0"
+version = "0.18.0.post0"
 description = "Fast and easy dependency injection framework."
 license = { text = "MIT" }
 readme = "README.md"
@@ -119,5 +124,5 @@ ignore = ["N818"]
 fixable = ["ALL"]
 
 [tool.uv]
-default-groups = ["bench", "dev", "test"]
+default-groups = ["bench", "dev", "doc", "test"]
 package = true