python-injection 0.8.5__py3-none-any.whl → 0.9.1__py3-none-any.whl

injection/__init__.py

@@ -7,7 +7,6 @@ __all__ = (
     "InjectableMode",
     "Module",
     "ModulePriority",
-    "default_module",
     "get_instance",
     "get_lazy_instance",
     "inject",
@@ -17,12 +16,14 @@ __all__ = (
     "singleton",
 )
 
-default_module = Module(f"{__name__}:default_module")
+_module = Module.default()
 
-get_instance = default_module.get_instance
-get_lazy_instance = default_module.get_lazy_instance
-inject = default_module.inject
-injectable = default_module.injectable
-set_constant = default_module.set_constant
-should_be_injectable = default_module.should_be_injectable
-singleton = default_module.singleton
+get_instance = _module.get_instance
+get_lazy_instance = _module.get_lazy_instance
+inject = _module.inject
+injectable = _module.injectable
+set_constant = _module.set_constant
+should_be_injectable = _module.should_be_injectable
+singleton = _module.singleton
+
+del _module

injection/__init__.pyi

@@ -1,33 +1,34 @@
 from abc import abstractmethod
-from collections.abc import Callable, Iterable
+from collections.abc import Callable
 from contextlib import ContextDecorator
-from enum import Enum
+from enum import StrEnum
 from types import UnionType
 from typing import (
     Any,
     ContextManager,
-    Final,
-    Literal,
     Protocol,
-    TypeVar,
+    Self,
     final,
     runtime_checkable,
 )
 
 from .common.invertible import Invertible
+from .common.tools.type import TypeInfo
+from .core import InjectableFactory
+from .core import ModeStr as InjectableModeStr
+from .core import PriorityStr as ModulePriorityStr
 
-_T = TypeVar("_T")
-_T_co = TypeVar("_T_co", covariant=True)
+_module: Module = ...
 
-default_module: Final[Module] = ...
+get_instance = _module.get_instance
+get_lazy_instance = _module.get_lazy_instance
+inject = _module.inject
+injectable = _module.injectable
+set_constant = _module.set_constant
+should_be_injectable = _module.should_be_injectable
+singleton = _module.singleton
 
-get_instance = default_module.get_instance
-get_lazy_instance = default_module.get_lazy_instance
-inject = default_module.inject
-injectable = default_module.injectable
-set_constant = default_module.set_constant
-should_be_injectable = default_module.should_be_injectable
-singleton = default_module.singleton
+del _module
 
 @final
 class Module:
@@ -41,6 +42,8 @@ class Module:
 
     def __init__(self, name: str = ...): ...
     def __contains__(self, cls: type | UnionType, /) -> bool: ...
+    @property
+    def is_locked(self) -> bool: ...
     def inject(self, wrapped: Callable[..., Any] = ..., /):
         """
         Decorator applicable to a class or function. Inject function dependencies using
@@ -48,15 +51,15 @@ class Module:
         will be those of the `__init__` method.
         """
 
-    def injectable(
+    def injectable[T](
         self,
-        wrapped: Callable[..., Any] = ...,
+        wrapped: Callable[..., T] = ...,
         /,
         *,
-        cls: type[Injectable] = ...,
+        cls: InjectableFactory[T] = ...,
         inject: bool = ...,
-        on: type | Iterable[type] | UnionType = ...,
-        mode: InjectableMode | Literal["fallback", "normal", "override"] = ...,
+        on: TypeInfo[T] = ...,
+        mode: InjectableMode | InjectableModeStr = ...,
     ):
         """
         Decorator applicable to a class or function. It is used to indicate how the
@@ -64,14 +67,14 @@ class Module:
         injected each time.
         """
 
-    def singleton(
+    def singleton[T](
         self,
-        wrapped: Callable[..., Any] = ...,
+        wrapped: Callable[..., T] = ...,
         /,
         *,
         inject: bool = ...,
-        on: type | Iterable[type] | UnionType = ...,
-        mode: InjectableMode | Literal["fallback", "normal", "override"] = ...,
+        on: TypeInfo[T] = ...,
+        mode: InjectableMode | InjectableModeStr = ...,
     ):
         """
         Decorator applicable to a class or function. It is used to indicate how the
@@ -86,37 +89,37 @@ class Module:
         registered.
         """
 
-    def set_constant(
+    def set_constant[T](
         self,
-        instance: _T,
-        on: type | Iterable[type] | UnionType = ...,
+        instance: T,
+        on: TypeInfo[T] = ...,
         *,
-        mode: InjectableMode | Literal["fallback", "normal", "override"] = ...,
-    ) -> _T:
+        mode: InjectableMode | InjectableModeStr = ...,
+    ) -> T:
         """
         Function for registering a specific instance to be injected. This is useful for
         registering global variables. The difference with the singleton decorator is
         that no dependencies are resolved, so the module doesn't need to be locked.
         """
 
-    def resolve(self, cls: type[_T]) -> _T:
+    def resolve[T](self, cls: type[T]) -> T:
         """
         Function used to retrieve an instance associated with the type passed in
         parameter or an exception will be raised.
         """
 
-    def get_instance(self, cls: type[_T]) -> _T | None:
+    def get_instance[T](self, cls: type[T]) -> T | None:
         """
         Function used to retrieve an instance associated with the type passed in
         parameter or return `None`.
         """
 
-    def get_lazy_instance(
+    def get_lazy_instance[T](
         self,
-        cls: type[_T],
+        cls: type[T],
         *,
         cache: bool = ...,
-    ) -> Invertible[_T | None]:
+    ) -> Invertible[T | None]:
         """
         Function used to retrieve an instance associated with the type passed in
         parameter or `None`. Return a `Invertible` object. To access the instance
@@ -126,19 +129,24 @@ class Module:
         Example: instance = ~lazy_instance
         """
 
+    def init_modules(self, *modules: Module) -> Self:
+        """
+        Function to clean modules in use and to use those passed as parameters.
+        """
+
     def use(
         self,
         module: Module,
         *,
-        priority: ModulePriority | Literal["low", "high"] = ...,
-    ):
+        priority: ModulePriority | ModulePriorityStr = ...,
+    ) -> Self:
         """
         Function for using another module. Using another module replaces the module's
         dependencies with those of the module used. If the dependency is not found, it
         will be searched for in the module's dependency container.
         """
 
-    def stop_using(self, module: Module):
+    def stop_using(self, module: Module) -> Self:
         """
         Function to remove a module in use.
         """
@@ -147,7 +155,7 @@ class Module:
         self,
         module: Module,
         *,
-        priority: ModulePriority | Literal["low", "high"] = ...,
+        priority: ModulePriority | ModulePriorityStr = ...,
     ) -> ContextManager | ContextDecorator:
         """
         Context manager or decorator for temporary use of a module.
@@ -156,8 +164,8 @@ class Module:
     def change_priority(
         self,
         module: Module,
-        priority: ModulePriority | Literal["low", "high"],
-    ):
+        priority: ModulePriority | ModulePriorityStr,
+    ) -> Self:
         """
         Function for changing the priority of a module in use.
         There are two priority values:
@@ -166,27 +174,38 @@ class Module:
         * **HIGH**: The module concerned becomes the most important of the modules used.
         """
 
-    def unlock(self):
+    def unlock(self) -> Self:
         """
         Function to unlock the module by deleting cached instances of singletons.
         """
 
+    @classmethod
+    def from_name(cls, name: str) -> Self:
+        """
+        Class method for getting or creating a module by name.
+        """
+
+    @classmethod
+    def default(cls) -> Self:
+        """
+        Class method for getting the default module.
+        """
+
 @final
-class ModulePriority(str, Enum):
+class ModulePriority(StrEnum):
     LOW = ...
     HIGH = ...
 
 @runtime_checkable
-class Injectable(Protocol[_T_co]):
-    def __init__(self, factory: Callable[[], _T_co] = ..., /): ...
+class Injectable[T](Protocol):
     @property
     def is_locked(self) -> bool: ...
     def unlock(self): ...
     @abstractmethod
-    def get_instance(self) -> _T_co: ...
+    def get_instance(self) -> T: ...
 
 @final
-class InjectableMode(str, Enum):
+class InjectableMode(StrEnum):
     FALLBACK = ...
     NORMAL = ...
     OVERRIDE = ...

injection/common/event.py

@@ -1,7 +1,7 @@
 from abc import ABC, abstractmethod
 from contextlib import ExitStack, contextmanager, suppress
 from dataclasses import dataclass, field
-from typing import ContextManager
+from typing import ContextManager, Self
 from weakref import WeakSet
 
 __all__ = ("Event", "EventChannel", "EventListener")
@@ -36,11 +36,11 @@ class EventChannel:
 
             yield
 
-    def add_listener(self, listener: EventListener):
+    def add_listener(self, listener: EventListener) -> Self:
         self.__listeners.add(listener)
         return self
 
-    def remove_listener(self, listener: EventListener):
+    def remove_listener(self, listener: EventListener) -> Self:
         with suppress(KeyError):
             self.__listeners.remove(listener)
 

injection/common/invertible.py

@@ -1,23 +1,21 @@
 from abc import abstractmethod
 from collections.abc import Callable
 from dataclasses import dataclass
-from typing import Protocol, TypeVar, runtime_checkable
+from typing import Protocol, runtime_checkable
 
 __all__ = ("Invertible", "SimpleInvertible")
 
-_T_co = TypeVar("_T_co", covariant=True)
-
 
 @runtime_checkable
-class Invertible(Protocol[_T_co]):
+class Invertible[T](Protocol):
     @abstractmethod
-    def __invert__(self) -> _T_co:
+    def __invert__(self) -> T:
         raise NotImplementedError
 
 
 @dataclass(repr=False, eq=False, frozen=True, slots=True)
-class SimpleInvertible(Invertible[_T_co]):
-    callable: Callable[[], _T_co]
+class SimpleInvertible[T](Invertible[T]):
+    callable: Callable[[], T]
 
-    def __invert__(self) -> _T_co:
+    def __invert__(self) -> T:
         return self.callable()

injection/common/lazy.py

@@ -1,31 +1,26 @@
 from collections.abc import Callable, Iterator, Mapping
 from types import MappingProxyType
-from typing import TypeVar
 
 from injection.common.invertible import Invertible
 
 __all__ = ("Lazy", "LazyMapping")
 
-_T = TypeVar("_T")
-_K = TypeVar("_K")
-_V = TypeVar("_V")
 
-
-class Lazy(Invertible[_T]):
+class Lazy[T](Invertible[T]):
     __slots__ = ("__cache", "__is_set")
 
-    def __init__(self, factory: Callable[[], _T]):
+    def __init__(self, factory: Callable[[], T]):
         self.__setup_cache(factory)
 
-    def __invert__(self) -> _T:
+    def __invert__(self) -> T:
         return next(self.__cache)
 
     @property
     def is_set(self) -> bool:
         return self.__is_set
 
-    def __setup_cache(self, factory: Callable[[], _T]):
-        def cache_generator() -> Iterator[_T]:
+    def __setup_cache(self, factory: Callable[[], T]):
+        def cache_generator() -> Iterator[T]:
             nonlocal factory
             cached = factory()
             self.__is_set = True
@@ -38,16 +33,16 @@ class Lazy(Invertible[_T]):
         self.__is_set = False
 
 
-class LazyMapping(Mapping[_K, _V]):
+class LazyMapping[K, V](Mapping[K, V]):
     __slots__ = ("__lazy",)
 
-    def __init__(self, iterator: Iterator[tuple[_K, _V]]):
+    def __init__(self, iterator: Iterator[tuple[K, V]]):
         self.__lazy = Lazy(lambda: MappingProxyType(dict(iterator)))
 
-    def __getitem__(self, key: _K, /) -> _V:
+    def __getitem__(self, key: K, /) -> V:
         return (~self.__lazy)[key]
 
-    def __iter__(self) -> Iterator[_K]:
+    def __iter__(self) -> Iterator[K]:
         yield from ~self.__lazy
 
     def __len__(self) -> int:

injection/common/tools/threading.py

@@ -3,10 +3,10 @@ from threading import RLock
 
 __all__ = ("synchronized",)
 
-__lock = RLock()
-
 
 @contextmanager
 def synchronized():
-    with __lock:
-        yield
+    lock = RLock()
+
+    with lock:
+        yield lock

injection/common/tools/type.py

@@ -1,48 +1,75 @@
-from collections.abc import Iterable, Iterator
+from collections.abc import Callable, Iterable, Iterator
 from inspect import get_annotations, isfunction
-from types import NoneType, UnionType
-from typing import Annotated, Any, Union, get_args, get_origin
+from types import UnionType
+from typing import (
+    Annotated,
+    Any,
+    NamedTuple,
+    Self,
+    Union,
+    get_args,
+    get_origin,
+)
 
-__all__ = ("find_types", "format_type", "get_origins")
+__all__ = ("TypeInfo", "TypeReport", "analyze_types", "get_return_types")
 
+type TypeInfo[T] = type[T] | Callable[..., T] | Iterable[TypeInfo[T]] | UnionType
 
-def format_type(cls: type | Any) -> str:
-    try:
-        return f"{cls.__module__}.{cls.__qualname__}"
-    except AttributeError:
-        return str(cls)
 
+class TypeReport[T](NamedTuple):
+    origin: type[T]
+    args: tuple[Any, ...]
 
-def get_origins(*types: type | Any) -> Iterator[type | Any]:
-    for tp in types:
-        origin = get_origin(tp) or tp
+    @property
+    def type(self) -> type[T]:
+        origin = self.origin
+
+        if args := self.args:
+            return origin[*args]
+
+        return origin
+
+    @property
+    def no_args(self) -> Self:
+        if self.args:
+            return type(self)(self.origin, ())
 
-        if origin in (None, NoneType):
+        return self
+
+
+def analyze_types(*types: type | Any) -> Iterator[TypeReport[Any]]:
+    for tp in types:
+        if tp is None:
             continue
 
-        elif origin in (Union, UnionType):
-            args = get_args(tp)
+        origin = get_origin(tp)
+
+        if origin is Union or isinstance(tp, UnionType):
+            inner_types = get_args(tp)
 
-        elif origin is Annotated is not tp:
-            args = get_args(tp)[:1]
+        elif origin is Annotated:
+            inner_types = get_args(tp)[:1]
 
         else:
-            yield origin
+            yield TypeReport(origin or tp, get_args(tp))
             continue
 
-        yield from get_origins(*args)
+        yield from analyze_types(*inner_types)
 
 
-def find_types(*args: Any) -> Iterator[type | UnionType]:
-    for argument in args:
-        if isinstance(argument, Iterable) and not isinstance(argument, type | str):
-            arguments = argument
+def get_return_types(*args: TypeInfo[Any]) -> Iterator[type | UnionType]:
+    for arg in args:
+        if isinstance(arg, Iterable) and not isinstance(
+            get_origin(arg) or arg,
+            type | str,
+        ):
+            inner_args = arg
 
-        elif isfunction(argument):
-            arguments = (get_annotations(argument, eval_str=True).get("return"),)
+        elif isfunction(arg):
+            inner_args = (get_annotations(arg, eval_str=True).get("return"),)
 
         else:
-            yield argument
+            yield arg
             continue
 
-        yield from find_types(*arguments)
+        yield from get_return_types(*inner_args)

injection/core/module.py

@@ -14,7 +14,7 @@ from collections.abc import (
 )
 from contextlib import contextmanager, suppress
 from dataclasses import dataclass, field
-from enum import Enum
+from enum import StrEnum
 from functools import partialmethod, singledispatchmethod, update_wrapper
 from inspect import Signature, isclass
 from queue import Queue
@@ -27,7 +27,7 @@ from typing import (
     NamedTuple,
     NoReturn,
     Protocol,
-    TypeVar,
+    Self,
     runtime_checkable,
 )
 
@@ -35,7 +35,12 @@ from injection.common.event import Event, EventChannel, EventListener
 from injection.common.invertible import Invertible, SimpleInvertible
 from injection.common.lazy import Lazy, LazyMapping
 from injection.common.tools.threading import synchronized
-from injection.common.tools.type import find_types, format_type, get_origins
+from injection.common.tools.type import (
+    TypeInfo,
+    TypeReport,
+    analyze_types,
+    get_return_types,
+)
 from injection.exceptions import (
     InjectionError,
     ModuleError,
@@ -44,13 +49,18 @@ from injection.exceptions import (
     NoInjectable,
 )
 
-__all__ = ("Injectable", "Mode", "Module", "Priority")
+__all__ = (
+    "Injectable",
+    "InjectableFactory",
+    "Mode",
+    "ModeStr",
+    "Module",
+    "Priority",
+    "PriorityStr",
+)
 
 _logger = logging.getLogger(__name__)
 
-_T = TypeVar("_T")
-_T_co = TypeVar("_T_co", covariant=True)
-
 """
 Events
 """
@@ -63,15 +73,15 @@ class ContainerEvent(Event, ABC):
 
 @dataclass(frozen=True, slots=True)
 class ContainerDependenciesUpdated(ContainerEvent):
-    classes: Collection[type]
+    reports: Collection[TypeReport]
     mode: Mode
 
     def __str__(self) -> str:
-        length = len(self.classes)
-        formatted_classes = ", ".join(f"`{format_type(cls)}`" for cls in self.classes)
+        length = len(self.reports)
+        formatted_types = ", ".join(f"`{report.type}`" for report in self.reports)
         return (
-            f"{length} container dependenc{'ies' if length > 1 else 'y'} have been "
-            f"updated{f': {formatted_classes}' if formatted_classes else ''}."
+            f"{length} container dependenc{'ies' if length > 1 else 'y'} have "
+            f"been updated{f': {formatted_types}' if formatted_types else ''}."
         )
 
 
@@ -134,12 +144,9 @@ Injectables
 
 
 @runtime_checkable
-class Injectable(Protocol[_T_co]):
+class Injectable[T](Protocol):
     __slots__ = ()
 
-    def __init__(self, __factory: Callable[[], _T_co] = None, /):
-        pass
-
     @property
     def is_locked(self) -> bool:
         return False
@@ -148,26 +155,26 @@ class Injectable(Protocol[_T_co]):
         return
 
     @abstractmethod
-    def get_instance(self) -> _T_co:
+    def get_instance(self) -> T:
         raise NotImplementedError
 
 
 @dataclass(repr=False, frozen=True, slots=True)
-class BaseInjectable(Injectable[_T], ABC):
-    factory: Callable[[], _T]
+class BaseInjectable[T](Injectable[T], ABC):
+    factory: Callable[[], T]
 
 
-class NewInjectable(BaseInjectable[_T]):
+class NewInjectable[T](BaseInjectable[T]):
     __slots__ = ()
 
-    def get_instance(self) -> _T:
+    def get_instance(self) -> T:
         return self.factory()
 
 
-class SingletonInjectable(BaseInjectable[_T]):
+class SingletonInjectable[T](BaseInjectable[T]):
     __slots__ = ("__dict__",)
 
-    __INSTANCE_KEY: ClassVar[str] = "$instance"
+    __key: ClassVar[str] = "$instance"
 
     @property
     def cache(self) -> MutableMapping[str, Any]:
@@ -175,28 +182,28 @@ class SingletonInjectable(BaseInjectable[_T]):
 
     @property
     def is_locked(self) -> bool:
-        return self.__INSTANCE_KEY in self.cache
+        return self.__key in self.cache
 
     def unlock(self):
         self.cache.clear()
 
-    def get_instance(self) -> _T:
+    def get_instance(self) -> T:
         with suppress(KeyError):
-            return self.cache[self.__INSTANCE_KEY]
+            return self.cache[self.__key]
 
         with synchronized():
             instance = self.factory()
-            self.cache[self.__INSTANCE_KEY] = instance
+            self.cache[self.__key] = instance
 
         return instance
 
 
 @dataclass(repr=False, frozen=True, slots=True)
-class ShouldBeInjectable(Injectable[_T]):
-    cls: type[_T]
+class ShouldBeInjectable[T](Injectable[T]):
+    cls: type[T]
 
     def get_instance(self) -> NoReturn:
-        raise InjectionError(f"`{format_type(self.cls)}` should be an injectable.")
+        raise InjectionError(f"`{self.cls}` should be an injectable.")
 
 
 """
@@ -209,7 +216,7 @@ class Broker(Protocol):
     __slots__ = ()
 
     @abstractmethod
-    def __getitem__(self, cls: type[_T] | UnionType, /) -> Injectable[_T]:
+    def __getitem__[T](self, cls: type[T] | UnionType, /) -> Injectable[T]:
         raise NotImplementedError
 
     @abstractmethod
@@ -222,7 +229,7 @@ class Broker(Protocol):
         raise NotImplementedError
 
     @abstractmethod
-    def unlock(self):
+    def unlock(self) -> Self:
         raise NotImplementedError
 
 
@@ -231,7 +238,7 @@ Container
 """
 
 
-class Mode(str, Enum):
+class Mode(StrEnum):
     FALLBACK = "fallback"
     NORMAL = "normal"
     OVERRIDE = "override"
@@ -241,36 +248,37 @@ class Mode(str, Enum):
         return tuple(type(self)).index(self)
 
     @classmethod
-    def get_default(cls):
+    def get_default(cls) -> Mode:
         return cls.NORMAL
 
 
-ModeStr = Literal["fallback", "normal", "override"]
+type ModeStr = Literal["fallback", "normal", "override"]
 
 
-class Record(NamedTuple):
-    injectable: Injectable
+class Record[T](NamedTuple):
+    injectable: Injectable[T]
     mode: Mode
 
 
 @dataclass(repr=False, frozen=True, slots=True)
 class Container(Broker):
-    __records: dict[type, Record] = field(default_factory=dict, init=False)
+    __records: dict[TypeReport, Record] = field(default_factory=dict, init=False)
     __channel: EventChannel = field(default_factory=EventChannel, init=False)
 
-    def __getitem__(self, cls: type[_T] | UnionType, /) -> Injectable[_T]:
-        for cls in get_origins(cls):
-            try:
-                injectable, _ = self.__records[cls]
-            except KeyError:
-                continue
+    def __getitem__[T](self, cls: type[T] | UnionType, /) -> Injectable[T]:
+        for report in analyze_types(cls):
+            for scoped_report in dict.fromkeys((report, report.no_args)):
+                try:
+                    injectable, _ = self.__records[scoped_report]
+                except KeyError:
+                    continue
 
-            return injectable
+                return injectable
 
         raise NoInjectable(cls)
 
     def __contains__(self, cls: type | UnionType, /) -> bool:
-        return any(cls in self.__records for cls in get_origins(cls))
+        return any(report in self.__records for report in analyze_types(cls))
 
     @property
     def is_locked(self) -> bool:
@@ -281,16 +289,16 @@ class Container(Broker):
         return frozenset(injectable for injectable, _ in self.__records.values())
 
     @synchronized()
-    def update(
+    def update[T](
         self,
-        classes: Iterable[type | UnionType],
-        injectable: Injectable,
+        classes: Iterable[type[T] | UnionType],
+        injectable: Injectable[T],
         mode: Mode | ModeStr,
-    ):
+    ) -> Self:
         mode = Mode(mode)
         records = {
-            cls: Record(injectable, mode)
-            for cls in self.__classes_to_update(classes, mode)
+            report: Record(injectable, mode)
+            for report in self.__prepare_reports_for_updating(classes, mode)
         }
 
         if records:
@@ -302,43 +310,43 @@ class Container(Broker):
         return self
 
     @synchronized()
-    def unlock(self):
+    def unlock(self) -> Self:
         for injectable in self.__injectables:
             injectable.unlock()
 
         return self
 
-    def add_listener(self, listener: EventListener):
+    def add_listener(self, listener: EventListener) -> Self:
         self.__channel.add_listener(listener)
         return self
 
-    def notify(self, event: Event):
+    def notify(self, event: Event) -> ContextManager:
         return self.__channel.dispatch(event)
 
-    def __classes_to_update(
+    def __prepare_reports_for_updating(
         self,
         classes: Iterable[type | UnionType],
         mode: Mode,
-    ) -> Iterator[type]:
+    ) -> Iterator[TypeReport]:
         rank = mode.rank
 
-        for cls in frozenset(get_origins(*classes)):
+        for report in frozenset(analyze_types(*classes)):
             try:
-                _, current_mode = self.__records[cls]
+                _, current_mode = self.__records[report]
 
             except KeyError:
                 pass
 
             else:
-                if mode == current_mode:
+                if mode == current_mode and mode != Mode.OVERRIDE:
                     raise RuntimeError(
-                        f"An injectable already exists for the class `{format_type(cls)}`."
+                        f"An injectable already exists for the class `{report.type}`."
                     )
 
                 elif rank < current_mode.rank:
                     continue
 
-            yield cls
+            yield report
 
 
 """
@@ -346,47 +354,57 @@ Module
 """
 
 
-class Priority(str, Enum):
+class Priority(StrEnum):
     LOW = "low"
     HIGH = "high"
 
     @classmethod
-    def get_default(cls):
+    def get_default(cls) -> Priority:
         return cls.LOW
 
 
-PriorityStr = Literal["low", "high"]
+type PriorityStr = Literal["low", "high"]
 
+type InjectableFactory[T] = Callable[[Callable[..., T]], Injectable[T]]
 
-@dataclass(repr=False, eq=False, frozen=True, slots=True)
+
+@dataclass(eq=False, frozen=True, slots=True)
 class Module(EventListener, Broker):
     name: str | None = field(default=None)
-    __channel: EventChannel = field(default_factory=EventChannel, init=False)
-    __container: Container = field(default_factory=Container, init=False)
+    __channel: EventChannel = field(
+        default_factory=EventChannel,
+        init=False,
+        repr=False,
+    )
+    __container: Container = field(
+        default_factory=Container,
+        init=False,
+        repr=False,
+    )
     __modules: OrderedDict[Module, None] = field(
         default_factory=OrderedDict,
         init=False,
+        repr=False,
     )
 
+    __instances: ClassVar[dict[str, Module]] = {}
+
     def __post_init__(self):
         self.__container.add_listener(self)
 
-    def __getitem__(self, cls: type[_T] | UnionType, /) -> Injectable[_T]:
+    def __getitem__[T](self, cls: type[T] | UnionType, /) -> Injectable[T]:
         for broker in self.__brokers:
             with suppress(KeyError):
                 return broker[cls]
 
         raise NoInjectable(cls)
 
-    def __setitem__(self, cls: type | UnionType, injectable: Injectable, /):
+    def __setitem__[T](self, cls: type[T] | UnionType, injectable: Injectable[T], /):
         self.update((cls,), injectable)
 
     def __contains__(self, cls: type | UnionType, /) -> bool:
         return any(cls in broker for broker in self.__brokers)
 
-    def __str__(self) -> str:
-        return self.name or object.__str__(self)
-
     @property
     def is_locked(self) -> bool:
         return any(broker.is_locked for broker in self.__brokers)
@@ -396,20 +414,20 @@ class Module(EventListener, Broker):
         yield from tuple(self.__modules)
         yield self.__container
 
-    def injectable(
+    def injectable[T](
         self,
-        wrapped: Callable[..., Any] = None,
+        wrapped: Callable[..., T] = None,
         /,
         *,
-        cls: type[Injectable] = NewInjectable,
+        cls: InjectableFactory[T] = NewInjectable,
         inject: bool = True,
-        on: type | Iterable[type] | UnionType = (),
+        on: TypeInfo[T] = (),
         mode: Mode | ModeStr = Mode.get_default(),
     ):
         def decorator(wp):
             factory = self.inject(wp, return_factory=True) if inject else wp
             injectable = cls(factory)
-            classes = find_types(wp, on)
+            classes = get_return_types(wp, on)
             self.update(classes, injectable, mode)
             return wp
 
@@ -428,18 +446,18 @@ class Module(EventListener, Broker):
 
         return decorator(wrapped) if wrapped else decorator
 
-    def set_constant(
+    def set_constant[T](
         self,
-        instance: _T,
-        on: type | Iterable[type] | UnionType = (),
+        instance: T,
+        on: TypeInfo[T] = (),
         *,
         mode: Mode | ModeStr = Mode.get_default(),
-    ) -> _T:
+    ) -> T:
         cls = type(instance)
         self.injectable(
             lambda: instance,
             inject=False,
-            on=(cls, on),  # type: ignore
+            on=(cls, on),
             mode=mode,
         )
         return instance
@@ -458,7 +476,7 @@ class Module(EventListener, Broker):
 
             function = InjectedFunction(wp)
 
-            @function.on_setup
+            @function.on_setup(block=False)
             def listen():
                 function.update(self)
                 self.add_listener(function)
@@ -467,22 +485,22 @@ class Module(EventListener, Broker):
 
         return decorator(wrapped) if wrapped else decorator
 
-    def resolve(self, cls: type[_T]) -> _T:
+    def resolve[T](self, cls: type[T]) -> T:
         injectable = self[cls]
         return injectable.get_instance()
 
-    def get_instance(self, cls: type[_T]) -> _T | None:
+    def get_instance[T](self, cls: type[T]) -> T | None:
         try:
             return self.resolve(cls)
         except KeyError:
             return None
 
-    def get_lazy_instance(
+    def get_lazy_instance[T](
         self,
-        cls: type[_T],
+        cls: type[T],
         *,
         cache: bool = False,
-    ) -> Invertible[_T | None]:
+    ) -> Invertible[T | None]:
         if cache:
             return Lazy(lambda: self.get_instance(cls))
 
@@ -490,21 +508,30 @@ class Module(EventListener, Broker):
         function.set_owner(cls)
         return SimpleInvertible(function)
 
-    def update(
+    def update[T](
         self,
-        classes: Iterable[type | UnionType],
-        injectable: Injectable,
+        classes: Iterable[type[T] | UnionType],
+        injectable: Injectable[T],
         mode: Mode | ModeStr = Mode.get_default(),
-    ):
+    ) -> Self:
         self.__container.update(classes, injectable, mode)
         return self
 
+    def init_modules(self, *modules: Module) -> Self:
+        for module in tuple(self.__modules):
+            self.stop_using(module)
+
+        for module in modules:
+            self.use(module)
+
+        return self
+
     def use(
         self,
         module: Module,
         *,
         priority: Priority | PriorityStr = Priority.get_default(),
-    ):
+    ) -> Self:
         if module is self:
             raise ModuleError("Module can't be used by itself.")
 
@@ -521,7 +548,7 @@ class Module(EventListener, Broker):
 
         return self
 
-    def stop_using(self, module: Module):
+    def stop_using(self, module: Module) -> Self:
         event = ModuleRemoved(self, module)
 
         with suppress(KeyError):
@@ -542,7 +569,7 @@ class Module(EventListener, Broker):
         yield
         self.stop_using(module)
 
-    def change_priority(self, module: Module, priority: Priority | PriorityStr):
+    def change_priority(self, module: Module, priority: Priority | PriorityStr) -> Self:
         priority = Priority(priority)
         event = ModulePriorityUpdated(self, module, priority)
 
@@ -552,17 +579,17 @@ class Module(EventListener, Broker):
         return self
 
     @synchronized()
-    def unlock(self):
+    def unlock(self) -> Self:
         for broker in self.__brokers:
             broker.unlock()
 
         return self
 
-    def add_listener(self, listener: EventListener):
+    def add_listener(self, listener: EventListener) -> Self:
         self.__channel.add_listener(listener)
         return self
 
-    def remove_listener(self, listener: EventListener):
+    def remove_listener(self, listener: EventListener) -> Self:
         self.__channel.remove_listener(listener)
         return self
 
@@ -592,6 +619,19 @@ class Module(EventListener, Broker):
                 f"`{module}` can't be found in the modules used by `{self}`."
             ) from exc
 
+    @classmethod
+    def from_name(cls, name: str) -> Self:
+        with suppress(KeyError):
+            return cls.__instances[name]
+
+        instance = cls(name)
+        cls.__instances[name] = instance
+        return instance
+
+    @classmethod
+    def default(cls) -> Self:
+        return cls.from_name("default")
+
 
 """
 InjectedFunction
@@ -621,15 +661,15 @@ class Dependencies:
         return OrderedDict(self)
 
     @classmethod
-    def from_mapping(cls, mapping: Mapping[str, Injectable]):
-        return cls(mapping=mapping)
+    def from_mapping(cls, mapping: Mapping[str, Injectable]) -> Self:
+        return cls(mapping)
 
     @classmethod
-    def empty(cls):
+    def empty(cls) -> Self:
         return cls.from_mapping({})
 
     @classmethod
-    def resolve(cls, signature: Signature, module: Module, owner: type = None):
+    def resolve(cls, signature: Signature, module: Module, owner: type = None) -> Self:
         dependencies = LazyMapping(cls.__resolver(signature, module, owner))
         return cls.from_mapping(dependencies)
 
@@ -705,7 +745,7 @@ class InjectedFunction(EventListener):
         arguments = self.bind(args, kwargs)
         return self.wrapped(*arguments.args, **arguments.kwargs)
 
-    def __get__(self, instance: object = None, owner: type = None):
+    def __get__(self, instance: object = None, owner: type = None) -> Self | MethodType:
         if instance is None:
             return self
 
@@ -739,7 +779,7 @@ class InjectedFunction(EventListener):
         )
         return Arguments(bound.args, bound.kwargs)
 
-    def set_owner(self, owner: type):
+    def set_owner(self, owner: type) -> Self:
         if self.__dependencies.are_resolved:
             raise TypeError(
                 "Function owner must be assigned before dependencies are resolved."
@@ -752,19 +792,19 @@ class InjectedFunction(EventListener):
         return self
 
     @synchronized()
-    def update(self, module: Module):
+    def update(self, module: Module) -> Self:
         self.__dependencies = Dependencies.resolve(self.signature, module, self.__owner)
         return self
 
-    def on_setup(self, wrapped: Callable[[], Any] = None, /):
+    def on_setup(self, wrapped: Callable[[], Any] = None, /, *, block: bool = True):
         def decorator(wp):
-            self.__setup_queue.put(wp)
+            self.__setup_queue.put(wp, block=block)
             return wp
 
         return decorator(wrapped) if wrapped else decorator
 
     @singledispatchmethod
-    def on_event(self, event: Event, /) -> ContextManager | None:  # type: ignore
+    def on_event(self, event: Event, /) -> None:  # type: ignore
         return None
 
     @on_event.register
@@ -773,7 +813,7 @@ class InjectedFunction(EventListener):
         yield
         self.update(event.on_module)
 
-    def __set_signature(self):
+    def __set_signature(self) -> Self:
         self.__signature__ = inspect.signature(self.wrapped, eval_str=True)
         return self
 

injection/exceptions.py

@@ -1,7 +1,5 @@
 from typing import Any
 
-from injection.common.tools.type import format_type
-
 __all__ = (
     "InjectionError",
     "NoInjectable",
@@ -15,15 +13,15 @@ class InjectionError(Exception):
     pass
 
 
-class NoInjectable(KeyError, InjectionError):
+class NoInjectable[T](KeyError, InjectionError):
     __slots__ = ("__class",)
 
-    def __init__(self, cls: type | Any):
-        super().__init__(f"No injectable for `{format_type(cls)}`.")
+    def __init__(self, cls: type[T] | Any):
+        super().__init__(f"No injectable for `{cls}`.")
         self.__class = cls
 
     @property
-    def cls(self) -> type:
+    def cls(self) -> type[T]:
         return self.__class
 
 

injection/integrations/blacksheep.py

@@ -1,13 +1,11 @@
-from typing import Any, TypeVar
+from typing import Any
 
 from rodi import ContainerProtocol
 
-from injection import Module, default_module
+from injection import Module
 
 __all__ = ("InjectionServices",)
 
-_T = TypeVar("_T")
-
 
 class InjectionServices(ContainerProtocol):
     """
@@ -16,8 +14,8 @@ class InjectionServices(ContainerProtocol):
 
     __slots__ = ("__module",)
 
-    def __init__(self, module: Module = default_module):
-        self.__module = module
+    def __init__(self, module: Module = None):
+        self.__module = module or Module.default()
 
     def __contains__(self, item: Any) -> bool:
         return item in self.__module
@@ -26,5 +24,5 @@ class InjectionServices(ContainerProtocol):
         self.__module.injectable(obj_type)
         return self
 
-    def resolve(self, obj_type: type[_T] | Any, *args, **kwargs) -> _T:
+    def resolve[T](self, obj_type: type[T] | Any, *args, **kwargs) -> T:
         return self.__module.resolve(obj_type)

injection/testing/__init__.py

@@ -0,0 +1,38 @@
+from contextlib import contextmanager
+
+from injection import Module, ModulePriority
+
+__all__ = (
+    "set_test_constant",
+    "should_be_test_injectable",
+    "test_injectable",
+    "test_singleton",
+    "use_test_injectables",
+)
+
+
+def get_test_module() -> Module:
+    return Module.from_name("testing")
+
+
+_module = get_test_module()
+
+set_test_constant = _module.set_constant
+should_be_test_injectable = _module.should_be_injectable
+test_injectable = _module.injectable
+test_singleton = _module.singleton
+
+del _module
+
+
+@contextmanager
+def use_test_injectables(*, on: Module = None, test_module: Module = None):
+    on = on or Module.default()
+    test_module = test_module or get_test_module()
+
+    for module in (on, test_module):
+        module.unlock()
+
+    with on.use_temporarily(test_module, priority=ModulePriority.HIGH):
+        yield
+        on.unlock()

injection/testing/__init__.pyi

@@ -0,0 +1,22 @@
+from contextlib import ContextDecorator
+from typing import ContextManager
+
+from injection import Module
+
+_module: Module = ...
+
+set_test_constant = _module.set_constant
+should_be_test_injectable = _module.should_be_injectable
+test_injectable = _module.injectable
+test_singleton = _module.singleton
+
+del _module
+
+def use_test_injectables(
+    *,
+    on: Module = ...,
+    test_module: Module = ...,
+) -> ContextManager | ContextDecorator:
+    """
+    Context manager or decorator for temporary use test module.
+    """

{python_injection-0.8.5.dist-info → python_injection-0.9.1.dist-info}/METADATA

@@ -1,23 +1,21 @@
 Metadata-Version: 2.1
 Name: python-injection
-Version: 0.8.5
+Version: 0.9.1
 Summary: Fast and easy dependency injection framework.
 Home-page: https://github.com/100nm/python-injection
 License: MIT
 Keywords: dependencies,inject,injection
 Author: remimd
-Requires-Python: >=3.10,<4
+Requires-Python: >=3.12,<4
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Project-URL: Repository, https://github.com/100nm/python-injection
 Description-Content-Type: text/markdown
 
 # Basic usage
 
-## Create an injectable
+## Register an injectable
 
 > **Note**: If the class needs dependencies, these will be resolved when the instance is retrieved.
 

python_injection-0.9.1.dist-info/RECORD

@@ -0,0 +1,21 @@
+injection/__init__.py,sha256=LhfwYFMBw6tJ7XA_C353w61OPt4IuQQgs3zIjrwMIz8,654
+injection/__init__.pyi,sha256=dfIQAR8L8Yr7dM-DODR4czwUd2a7zzFQHzb8mr1Q6P0,6235
+injection/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/common/event.py,sha256=5Rdb2m3vAMCic8cQAVkStJDbrDrW_lk6kav8wYwmexM,1283
+injection/common/invertible.py,sha256=noNcmJ96IQi0XJms0dyfrx_AvKZnQM0sZyxhc2l6qo0,527
+injection/common/lazy.py,sha256=FEas6ewwOGWvRR8cflmyVvSLZd_-Fxd0QeIdvAM5I9c,1313
+injection/common/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/common/tools/threading.py,sha256=HlvP6k_-eZaK8JbB2b9PP171IZVe_0W2oMYsw3ebdKA,187
+injection/common/tools/type.py,sha256=ThM3Z1_gHmsdT4Jp7PlZgJY0lsufc4InPO65485Ugsg,1739
+injection/core/__init__.py,sha256=zuf0ubI2dHnbjn1059eduhS-ACIkkROa6-dhp10krh0,22
+injection/core/module.py,sha256=3FqU4XQgTNLI-VwpX1bKcRsLOaPeKSQ0sQuVsL_27I4,21625
+injection/exceptions.py,sha256=RsWWiWwKSMU0vxXQqQSn6CKHLMrGu4SSzYUAy9OJRXk,626
+injection/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/integrations/blacksheep.py,sha256=82P_owhF3FKIJxxalnSic3AJnoOr1mkojkWMefpO6QI,731
+injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+injection/testing/__init__.py,sha256=xglKmIJgg2j1wt8qWJ_TtGfFyKmn7xE7b8kQhD2yEkQ,864
+injection/testing/__init__.pyi,sha256=_u95cJVHBkt69HUvnu2bbfYWmi7GOH_1qyFyvC1PxBk,518
+injection/utils.py,sha256=_79aiciimZpuoUTz5lojKySUMMzpkU-e7SotiHIFTI8,676
+python_injection-0.9.1.dist-info/METADATA,sha256=6vDRDhsWCG-FbwiHs-pvslfia8Fpe2n7hWJPoxJJbhg,3572
+python_injection-0.9.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+python_injection-0.9.1.dist-info/RECORD,,

python_injection-0.8.5.dist-info/RECORD

@@ -1,19 +0,0 @@
-injection/__init__.py,sha256=Bf6S99E2srD3752xlJf3uAdiGIzY2YHOZafcwEiwY70,739
-injection/__init__.pyi,sha256=fNTW5TUZQmaxPooaa_vJ_nyR_-DqZ13hSWHh_TsdeOo,5913
-injection/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/common/event.py,sha256=TvkFv-5zF_oUTPhh5U0BKD5HanvCJKHA0H7yceMRy5c,1261
-injection/common/invertible.py,sha256=BZnkDg_NZDsTXGca5w5Wg_nYE3oRO_Wlodi2XtE55ck,595
-injection/common/lazy.py,sha256=1C34uoG229Gl0DEUcD9-eQrL4K_oIofOLzdQ1SiY6rw,1401
-injection/common/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/common/tools/threading.py,sha256=RAtzBFLVNJMflWIHxrP83fjafnFq8_JLgFoYQg8nVyE,182
-injection/common/tools/type.py,sha256=05fD5UkUI1kPoFWEjQz4j266SYfJQMK-Ti88JXNxb_M,1276
-injection/core/__init__.py,sha256=zuf0ubI2dHnbjn1059eduhS-ACIkkROa6-dhp10krh0,22
-injection/core/module.py,sha256=9QAYw5u8ULev3UWZCJ3R2dH9-xCqjc5e_9_19hrVWWw,20626
-injection/exceptions.py,sha256=f2lVSTAx-Nv89s0skn15y-sCkr656ROuWYs-XlrcEn8,683
-injection/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/integrations/blacksheep.py,sha256=dFXzrxkJRy9z44CcwG0ROYshT3zUZTVyuQkRy390RvU,765
-injection/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-injection/utils.py,sha256=_79aiciimZpuoUTz5lojKySUMMzpkU-e7SotiHIFTI8,676
-python_injection-0.8.5.dist-info/METADATA,sha256=ZUrcGLYxHJC3IIwnBDJgsA3wlZ25zTNHeopIVWi4EHM,3672
-python_injection-0.8.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-python_injection-0.8.5.dist-info/RECORD,,