python-injection 0.17.3.post0__py3-none-any.whl → 0.18.0__py3-none-any.whl

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 | None = ...,
+) -> EntrypointDecorator[P, T1, T2]: ...
+
+
+@overload
+def entrypointmaker[*Ts, **P, T1, T2](
+    wrapped: None = ...,
+    /,
+    *,
+    module: Module | None = ...,
+) -> 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

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.dist-info → python_injection-0.18.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-injection
-Version: 0.17.3.post0
+Version: 0.18.0
 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.dist-info → python_injection-0.18.0.dist-info}/RECORD

@@ -1,7 +1,8 @@
 injection/__init__.py,sha256=7ZRUlO5EEPWO7IlbYHD-8DOX-cg4Np4nYq5fpw-U56o,1259
 injection/__init__.pyi,sha256=O2W6ZWcwH58JnDmJNkJ6cdoaO0D2NE7PEVFgfJNTwB0,10717
+injection/entrypoint.py,sha256=wt8UoI2IFwn5A-nQe4GEPc6ynhRR7JXDWJxsHR3TKkU,4219
 injection/exceptions.py,sha256=v57yMujiq6H_zwwn30A8UYEZX9R9k-bY8FnsdaimPM4,1025
-injection/loaders.py,sha256=bLIVA_3N3mTEQ3kGV4YzrWEnokHxUGqWYNKPggOOnpg,4065
+injection/loaders.py,sha256=8tS3zVvmxKf5E1ZJBTBjZpHkXETxNCL1dq8rbh2vzy4,4075
 injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 injection/_core/descriptors.py,sha256=jH0pyIlPurMmU4yXr-HKS_7BJ-9d0XUvEx4pQre3QeI,704
@@ -21,6 +22,6 @@ injection/ext/fastapi.py,sha256=layUUer5IWiZX6Mmx1_RCYDLNCtEHtpya5ZL6TTBOkY,968
 injection/ext/fastapi.pyi,sha256=8OZEUjHFB9n7QXv_dtXdDuXW-r2huQEFsJ03gJOOvwQ,125
 injection/testing/__init__.py,sha256=PsrvNxYvn11if8CJpEYxcTxniqMt2w_7fBaDkY9RA5o,898
 injection/testing/__init__.pyi,sha256=iOii0i9F5n7znltGeGQYI2KXC_if9SAogLh1h03yx-0,540
-python_injection-0.17.3.post0.dist-info/METADATA,sha256=n-1M59B6b0yrl_d5BYkCGaPUj2T29RtOkqJq3y-mVNs,3266
-python_injection-0.17.3.post0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_injection-0.17.3.post0.dist-info/RECORD,,
+python_injection-0.18.0.dist-info/METADATA,sha256=SjlrHdr6R0csAv6-JVnPQarPgxYFSm0M1E6vZjhRLQ4,3364
+python_injection-0.18.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_injection-0.18.0.dist-info/RECORD,,