mirror of
https://github.com/ets-labs/python-dependency-injector.git
synced 2025-05-10 10:53:48 +03:00
f961ff536a
* Add single container prototype * Add multiple containers prototype * Add integration tests * Implement from_*() methods and add tests * Prototype inline injections * Add integration test for inline providers * Refactor integration tests * Add integration test for reordered schema * Remove unused imports from tests * Refactor schema module * Update tests to match latest schemas * Add mypy_boto3_s3 to the test requirements * Add boto3 to the test requirements * Add set_provides for Callable, Factory, and Singleton providers * Fix warnings in tests * Add typing stubs for Callable, Factory, and Singleton .set_provides() attributes * Fix singleton children to have optional provides * Implement provider to provider resolving * Fix pypy3 tests * Implement boto3 session use case and add tests * Implement lazy initialization and improve copying for Callable, Factory, Singleton, and Coroutine providers * Fix Python 2 tests * Add region name for boto3 integration example * Remove f-strings from set_provides() * Fix schema flake8 errors * Implement lazy initialization and improve copying for Delegate provider * Implement lazy initialization and improve copying for Object provider * Speed up wiring tests * Implement lazy initialization and improve copying for FactoryAggregate provider * Implement lazy initialization and improve copying for Selector provider * Implement lazy initialization and improve copying for Dependency provider * Implement lazy initialization and improve copying for Resource provider * Implement lazy initialization and improve copying for Configuration provider * Implement lazy initialization and improve copying for ProvidedInstance provider * Implement lazy initialization and improve copying for AttributeGetter provider * Implement lazy initialization and improve copying for ItemGetter provider * Implement lazy initialization and improve copying for MethodCaller provder * Update changelog * Fix typing in wiring module * Fix wiring module loader uninstallation issue * Fix provided instance providers error handing in asynchronous mode Co-authored-by: Roman Mogylatov <rmk@Romans-MacBook-Pro.local>
95 lines
3.2 KiB
Python
95 lines
3.2 KiB
Python
from pathlib import Path
|
|
from typing import (
|
|
Generic,
|
|
Type,
|
|
Dict,
|
|
Tuple,
|
|
Optional,
|
|
Any,
|
|
Union,
|
|
ClassVar,
|
|
Callable as _Callable,
|
|
Iterable,
|
|
Iterator,
|
|
TypeVar,
|
|
Awaitable,
|
|
overload,
|
|
)
|
|
|
|
from .providers import Provider, Self, ProviderParent
|
|
|
|
|
|
C_Base = TypeVar('C_Base', bound='Container')
|
|
C = TypeVar('C', bound='DeclarativeContainer')
|
|
C_Overriding = TypeVar('C_Overriding', bound='DeclarativeContainer')
|
|
T = TypeVar('T')
|
|
TT = TypeVar('TT')
|
|
|
|
|
|
class Container:
|
|
provider_type: Type[Provider] = Provider
|
|
providers: Dict[str, Provider]
|
|
dependencies: Dict[str, Provider]
|
|
overridden: Tuple[Provider]
|
|
__self__: Self
|
|
def __init__(self) -> None: ...
|
|
def __deepcopy__(self, memo: Optional[Dict[str, Any]]) -> Provider: ...
|
|
def __setattr__(self, name: str, value: Union[Provider, Any]) -> None: ...
|
|
def __getattr__(self, name: str) -> Provider: ...
|
|
def __delattr__(self, name: str) -> None: ...
|
|
def set_providers(self, **providers: Provider): ...
|
|
def set_provider(self, name: str, provider: Provider) -> None: ...
|
|
def override(self, overriding: C_Base) -> None: ...
|
|
def override_providers(self, **overriding_providers: Provider) -> None: ...
|
|
def reset_last_overriding(self) -> None: ...
|
|
def reset_override(self) -> None: ...
|
|
def wire(self, modules: Optional[Iterable[Any]] = None, packages: Optional[Iterable[Any]] = None) -> None: ...
|
|
def unwire(self) -> None: ...
|
|
def init_resources(self) -> Optional[Awaitable]: ...
|
|
def shutdown_resources(self) -> Optional[Awaitable]: ...
|
|
def apply_container_providers_overridings(self) -> None: ...
|
|
def reset_singletons(self) -> SingletonResetContext[C_Base]: ...
|
|
def check_dependencies(self) -> None: ...
|
|
def from_schema(self, schema: Dict[Any, Any]) -> None: ...
|
|
def from_yaml_schema(self, filepath: Union[Path, str], loader: Optional[Any]=None) -> None: ...
|
|
def from_json_schema(self, filepath: Union[Path, str]) -> None: ...
|
|
@overload
|
|
def resolve_provider_name(self, provider: Provider) -> str: ...
|
|
@classmethod
|
|
@overload
|
|
def resolve_provider_name(cls, provider: Provider) -> str: ...
|
|
@property
|
|
def parent(self) -> Optional[ProviderParent]: ...
|
|
@property
|
|
def parent_name(self) -> Optional[str]: ...
|
|
def assign_parent(self, parent: ProviderParent) -> None: ...
|
|
@overload
|
|
def traverse(self, types: Optional[Iterable[Type[TT]]] = None) -> Iterator[TT]: ...
|
|
@classmethod
|
|
@overload
|
|
def traverse(cls, types: Optional[Iterable[Type[TT]]] = None) -> Iterator[TT]: ...
|
|
|
|
|
|
class DynamicContainer(Container): ...
|
|
|
|
|
|
class DeclarativeContainer(Container):
|
|
cls_providers: ClassVar[Dict[str, Provider]]
|
|
inherited_providers: ClassVar[Dict[str, Provider]]
|
|
def __init__(self, **overriding_providers: Union[Provider, Any]) -> None: ...
|
|
|
|
|
|
class SingletonResetContext(Generic[T]):
|
|
def __init__(self, container: T): ...
|
|
def __enter__(self) -> T: ...
|
|
def __exit__(self, *_: Any) -> None: ...
|
|
|
|
|
|
def override(container: Type[C]) -> _Callable[[Type[C_Overriding]], Type[C_Overriding]]: ...
|
|
|
|
|
|
def copy(container: Type[C]) -> _Callable[[Type[C_Overriding]], Type[C_Overriding]]: ...
|
|
|
|
|
|
def is_container(instance: Any) -> bool: ...
|