Schemas (#429)

* 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>

Author: rmk135

docs/main/changelog.rst

@@ -7,6 +7,14 @@ that were made in every particular version.
 From version 0.7.6 *Dependency Injector* framework strictly 
 follows `Semantic versioning`_
 
+Development version
+-------------------
+- Implement providers' lazy initialization.
+- Improve providers' copying.
+- Improve typing in wiring module.
+- Fix wiring module loader uninstallation issue.
+- Fix provided instance providers error handing in asynchronous mode.
+
 4.30.0
 ------
 - Remove restriction to wire a dynamic container.

requirements-dev.txt

@@ -12,5 +12,7 @@ fastapi
 pydantic
 numpy
 scipy
+boto3
+mypy_boto3_s3
 
 -r requirements-ext.txt

src/dependency_injector/containers.c

@@ -1,3 +1,4 @@
+from pathlib import Path
 from typing import (
  Generic,
  Type,
@@ -34,6 +35,7 @@ class Container:
  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: ...
@@ -48,6 +50,9 @@ class Container:
  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

src/dependency_injector/containers.pyi

@@ -1,12 +1,18 @@
 """Containers module."""
 
+import json
 import sys
 
 try:
  import asyncio
 except ImportError:
  asyncio = None
 
+try:
+ import yaml
+except ImportError:
+ yaml = None
+
 import six
 
 from . import providers, errors
@@ -330,6 +336,39 @@ class DynamicContainer(Container):
  f'{", ".join(undefined_names)}',
  )
 
+ def from_schema(self, schema):
+ """Build container providers from schema."""
+ from .schema import build_schema
+ for name, provider in build_schema(schema).items():
+ self.set_provider(name, provider)
+
+ def from_yaml_schema(self, filepath, loader=None):
+ """Build container providers from YAML schema.
+
+ You can specify type of loader as a second argument. By default, method
+ uses ``SafeLoader``.
+ """
+ if yaml is None:
+ raise errors.Error(
+ 'Unable to load yaml schema - PyYAML is not installed. '
+ 'Install PyYAML or install Dependency Injector with yaml extras: '
+ '"pip install dependency-injector[yaml]"'
+ )
+
+ if loader is None:
+ loader = yaml.SafeLoader
+
+ with open(filepath) as file:
+ schema = yaml.load(file, loader)
+
+ self.from_schema(schema)
+
+ def from_json_schema(self, filepath):
+ """Build container providers from JSON schema."""
+ with open(filepath) as file:
+ schema = json.load(file)
+ self.from_schema(schema)
+
  def resolve_provider_name(self, provider):
  """Try to resolve provider name."""
  for provider_name, container_provider in self.providers.items():