dependency-injector

What's Changed

• Python 3.14 support
• Fix Pydantic v2 deprecation warning triggering on settings class import (fixes #942)
• Fix grammar in Declarative Container documentation by @okotdaniel in #916
• Add missing warn_unresolved parameter to WiringConfiguration in containers.pyi by @jonathandannenberg in #951
• Add keep_cache argument to Container.wire typings by @romantolkachyov in #952
• Retrofit assert type for some type-stub checks by @leonarduschen in #943
• Retrofit assert type for remaining type-stub checks by @leonarduschen in #953
• Add provided().call *args, **kwargs arguments #945 by @pavalso in #946
• Add context local resource by @elina-israyelyan in #931
• Update CI/CD to actions/checkout@v6, actions/setup-python@v6, actions/download-artifact@v8, actions/upload-artifact@v7 and pypa/cibuildwheel@v3.4.0.
• Add dependabot config for GitHub Actions

New Contributors

• @okotdaniel made their first contribution in #916
• @jonathandannenberg made their first contribution in #951
• @romantolkachyov made their first contribution in #952
• @pavalso made their first contribution in #946
• @elina-israyelyan made their first contribution in #931

Full Changelog: 4.48.3...4.49.0

What's Changed

• Fix providers.Resource missing overloads for AbstractContextManager and AbstractAsyncContextManager by @leonarduschen in #927
• Fast depends v3 compatibility fix by @AndrianEquestrian in #933
• Allow explicit typing on selector using TypeVar with default Any by @leonarduschen in #932
• Retrofit assert_type for Aggregate and Callable by @leonarduschen in #935
• Allow Annotated marker to be anywhere in the annotation list. by @BrianPugh in #939

New Contributors

• @leonarduschen made their first contribution in #927
• @BrianPugh made their first contribution in #939

Full Changelog: 4.48.1...4.48.3

What's Changed

• Fix grammar in Declarative Container documentation by @okotdaniel in #916
• Add warnings for unresolved markers by @ZipFile in 1222827
• Build ABI3 wheels only for Python>=3.10 by @ZipFile in 891f8b4

New Contributors

• @okotdaniel made their first contribution in #916

Full Changelog: 4.48.1...4.48.2

What's Changed

• Improve performance of dependency_injector._cwiring.DependencyResolver by @ZipFile in eb74b1e
• Add typing-extensions as a dependency for older Python versions (<3.11) by @ZipFile in be7d255
• Produce warning on @injects without Provide[...] marks by @ZipFile in 04b5907
• Add support for resource_type in Lifespans by @ZipFile in e6cc127

Full Changelog: 4.48.0...4.48.1

What's Changed

• Use cache in _fetch_reference_injections() by @ZipFile in #897
• Add Context Manager support to Resource provider by @ZipFile in #899
• Add support for async generator injections by @ZipFile in #900
• Add support for Fast Depends by @AndrianEquestrian in #898
• Add resource type parameter to init and shutdown resources using specialized providers by @amoncusir in #858

New Contributors

• @AndrianEquestrian made their first contribution in #898
• @amoncusir made their first contribution in #858

Full Changelog: 4.47.1...4.48.0

What's Changed

• Fix wiring marker typing by @ZipFile in #896
• Strip debug symbols in wheels

Full Changelog: 4.47.0...4.47.1

What's Changed

• Fix infinite loop with Closing+ConfigurationOption by @ZipFile in #871
• Remove unused root property from ConfigurationOption by @ZipFile in #875
• Fix incorrect monkeypatching during wire() that could violate MRO in some classes by @ZipFile in #886
• Add support for Annotated type for module and class attribute injection in wiring, with updated documentation and examples by @rmk135 in #889
• Publish ABI3 wheels for CPython by @ZipFile in #888 #887
• Drop Python 3.7 support by @ZipFile in #885 #864

Full Changelog: 4.46.0...4.47.0

What's Changed

• Migrate CI pipeline to actions/upload-artifact@v4 by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/847
• Fix type propogation through Provider by @philipbjorge in https://github.com/ets-labs/python-dependency-injector/pull/744 https://github.com/ets-labs/python-dependency-injector/pull/733
• Add test fixture and update documentation for movie-lister example by @mrKazzila in https://github.com/ets-labs/python-dependency-injector/pull/747
• Use native GHA ARM runners by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/849
• Add support for typing.Annotated by @maintain0404 in https://github.com/ets-labs/python-dependency-injector/pull/721
• Fix broken wiring of sync inject-decorated methods by @martlaf in https://github.com/ets-labs/python-dependency-injector/pull/673
• Add support for inspect.iscoroutinefunction() for Coroutine provider by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/830
• Update FastAPI examples to use Annotated[..., Depends(Provide[...])] by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/853
• Fix Closing dependency resolution by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/852
• Add option to disable env var interpolation in configs by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/861

New Contributors

• @philipbjorge made their first contribution in https://github.com/ets-labs/python-dependency-injector/pull/733
• @mrKazzila made their first contribution in https://github.com/ets-labs/python-dependency-injector/pull/747
• @maintain0404 made their first contribution in https://github.com/ets-labs/python-dependency-injector/pull/721
• @martlaf made their first contribution in https://github.com/ets-labs/python-dependency-injector/pull/673

Full Changelog: https://github.com/ets-labs/python-dependency-injector/compare/4.45.0...4.46.0

What's Changed

• Upgrade testing deps by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/837
• Update examples by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/838
• Fix grammar in docs by @dijonkitchen in https://github.com/ets-labs/python-dependency-injector/pull/709
• Remove six by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/840
• Improve debugability of deepcopy errors by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/839
• Raise exception instead of hiding it in finally by @gortibaldik in https://github.com/ets-labs/python-dependency-injector/pull/845
• Add Starlette lifespan handler implementation by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/683

New Contributors

• @dijonkitchen made their first contribution in https://github.com/ets-labs/python-dependency-injector/pull/709
• @gortibaldik made their first contribution in https://github.com/ets-labs/python-dependency-injector/pull/845

Full Changelog: https://github.com/ets-labs/python-dependency-injector/compare/4.44.0...4.45.0

What's Changed

• PEP-517 by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/829
• Pydantic 2 support by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/832
• Fix sdist build for publishing by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/836

Full Changelog: https://github.com/ets-labs/python-dependency-injector/compare/4.43.0...4.44.0

What's Changed

• Migrate to Cython3 by @ZipFile in https://github.com/ets-labs/python-dependency-injector/pull/813
• Add support for Python 3.13 by @rmk135 in https://github.com/ets-labs/python-dependency-injector/pull/828

Full Changelog: https://github.com/ets-labs/python-dependency-injector/compare/4.42.0...4.43.0

What's Changed

• Add a link to my Github Sponsors profile by @rmk135 in https://github.com/ets-labs/python-dependency-injector/pull/806
• Add Python 3.12 Support (#752) by @rmk135 in https://github.com/ets-labs/python-dependency-injector/pull/765

Full Changelog: https://github.com/ets-labs/python-dependency-injector/compare/4.41.0...4.42.0

• Add support of Python 3.12.

• Drop support of Python 2.7, 3.5, and 3.6.

• Regenerate C sources using Cython 0.29.37.

• Update cibuildwheel to version 2.20.0.

• Add support of Python 3.11.

• Allow Closing to detect dependent resources #633, #636. Thanks Jamie Stumme @StummeJ for the contribution.

• Update CI/CD to use Ubuntu 22.04.

• Update CI/CD to actions/checkout@v3, actions/setup-python@v4, actions/upload-artifact@v3, pypa/cibuildwheel@v2.11.3, and actions/download-artifact@v3.

• Fix install crash on non-utf8 systems #644.

• Fix a bug in Windows build with default charset #635.

• Update FastAPI Redis example to use aioredis version 2 #613.

• Update documentation on creating custom providers #598.

• Regenerate C sources using Cython 0.29.32.

• Fix builds badge.

• Add Configuration.from_json() method to load configuration from a json file.

• Fix bug with wiring not working properly with functions double wrapped by @functools.wraps decorator. See issue: #454. Many thanks to: @platipo, @MatthieuMoreau0, @fabiocerqueira, @Jitesh-Khuttan.

• Refactor wiring module to store all patched callable data in the PatchedRegistry.

• Improve wording on the "Dependency injection and inversion of control in Python" docs page.

• Add documentation on the @inject decorator.

• Update typing in the main example and cohesion/coupling correlation definition in "Dependency injection and inversion of control in Python". Thanks to @illia-v (Illia Volochii) for the PR (#580).

• Update copyright year.

• Enable skipped test test_schema_with_boto3_session().

• Update pytest configuration.

• Regenerate C sources using Cython 0.29.30.

• Fix bug #574: "@inject breaks inspect.iscoroutinefunction". Thanks to @burritoatspoton (Rafał Burczyński) for reporting the issue.

• Optimize injections and wiring from x1.5 to x7 times depending on the use case.

• Fix bug #569: "numpy.typing.NDArray breaks wiring". Thanks to @VKFisher (Vlad Fisher) for reporting the issue and providing a fix.

• Add new provider Aggregate. It is a generalized version of FactoryAggregate that can contain providers of any type, not only Factory. See issue #530. Thanks to @zerlok (Danil Troshnev) for suggesting the feature.

• Add argument as_ to the config.from_env() method for the explicit type casting of an environment variable value, e.g.: config.timeout.from_env("TIMEOUT", as_=int). See issue #533. Thanks to @gtors (Andrey Torsunov) for suggesting the feature.

• Add .providers attribute to the FactoryAggregate provider. It is an alias for FactoryAggregate.factories attribute.

• Add .set_providers() method to the FactoryAggregate provider. It is an alias for FactoryAggregate.set_factories() method.

• Add string imports for Factory, Singleton, Callable, Resource, and Coroutine providers, e.g. Factory("module.Class"). See issue #531. Thanks to @al-stefanitsky-mozdor for suggesting the feature.

• Fix Dependency provider to don't raise "Dependency is not defined" error when the default is a falsy value of proper type. See issue #550. Thanks to @approxit for reporting the issue.

• Refactor FactoryAggregate provider internals.

• Update logo on Github and in docs to support dark themes and remove some imperfections.

• Add support of Python 3.10.

• Improve wiring with adding importing modules and packages from a string container.wire(modules=["yourapp.module1"]).

• Add container wiring configuration wiring_config = containers.WiringConfiguration().

• Add support of with statement for container.override_providers() method.

• Add Configuration(yaml_files=[...]) argument.

• Add Configuration(ini_files=[...]) argument.

• Add Configuration(pydantic_settings=[...]) argument.

• Drop support of Python 3.4. There are no immediate breaking changes, but Dependency Injector will no longer be tested on Python 3.4 and any bugs will not be fixed.

• Announce the date of dropping Python 3.5 support (Jan 1st 2022).

• Fix Dependency.is_defined attribute to always return boolean value.

• Fix envs_required=False behavior in Configuration.from_*() methods to give a priority to the explicitly provided value.

• Update documentation and fix typos.

• Regenerate C sources using Cython 0.29.24.

• Migrate tests to pytest.

• Update docs.

• Add support of non-string keys for FactoryAggregate provider.

• Improve FactoryAggregate typing stub.

• Improve resource subclasses typing and make shutdown definition optional PR #492. Thanks to @EdwardBlair for suggesting the improvement.

• Fix type annotations for .provides. Thanks to Thiago Hiromi @thiromi for the fix PR #491.

• Fix environment variables interpolation examples in configuration provider docs {$ENV} -> ${ENV}. Thanks to Felipe Rubio @krouw for reporting the issue and fixing yaml example PR #494.

• Fix @containers.copy() decorator to respect dependencies on parent providers. See issue #477. Thanks to Andrey Torsunov @gtors for reporting the issue.

• Fix typing stub for container.override_providers() to accept other types besides Provider.

• Fix runtime issue with generic typing in resource initializer classes resources.Resource and resources.AsyncResource. See issue #488. Thanks to @EdwardBlair for reporting the issue.

• Update wiring to support modules provided as packages. See issue #481. Thanks to @Sadbot for demonstrating the issue.

• Fix a container issue with supporting custom string types. See issue #479. Thanks to @ilsurih for reporting the issue.

• Add support of six 1.16.0.

• Fix a bug with reverse shutdown order in container.shutdown_resources(). See issue #432. Thanks to Saulius Beinorius for bringing up the issue.

• Update container.shutdown_resources() to respect dependencies order while shutdown. See issue #432. Thanks to Saulius Beinorius for bringing up the issue.

• Add option envs_required for configuration provider .from_yaml() and .from_ini() methods. With envs_required=True methods .from_yaml() and .from_ini() raise an exception when encounter an undefined environment variable in the configuration file. By default this option is set to false for preserving previous behavior envs_required=False.

• Add raising of an exception in configuration provider strict mode when provider encounters an undefined environment variable in the configuration file.

• Update configuration provider environment variables interpolation to replace undefined environment variables with an empty value.

• Update configuration provider to perform environment variables interpolation before passing configuration file content to the parser.

• Add support of default value for environment variable in INI and YAML configuration files with ${ENV_NAME:default} format. See issue #459. Thanks to Maksym Shemet @hbmshemet for suggesting the feature.

• Add method Configuration.from_value(). See issue #462. Thanks to Mr. Slack Clone for bringing it up in the comments for configuration provider docs.

• This fix a typo in di_in_python.rst doc. Thanks to @loingo95 for the fix.

• Improve wiring fault tolerance. See issue #441. Thanks to @ssheng for reporting the issue.

• Fix a bug with List provider not working in async mode. See issue: #450. Thanks to @mxab for reporting the issue.

• Add async mode tests for List and Dict provider.

• Add ContextLocalSingleton provider. See PR: #443. Thanks to @sonthonaxrk for the contribution.

• Regenerate C sources using Cython 0.29.22.

• Fix an issue with Dict provider non-string keys. See issue: #435. Thanks to @daniel55411 for reporting the issue.

• Fix Flask scoped contexts example. See issue: #440. Thanks to @sonthonaxrk for the contribution.

• Fix ThreadSafeSingleton synchronization issue. See issue: #433. Thanks to @garlandhu for reporting the issue.

• 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.

• Fix overridden configuration option cache resetting. See issue: #428. Thanks to @dcendents for reporting the issue.

• Remove restriction to wire a dynamic container.

• Fix wiring to not crash on missing signatures. See issue: #420. Thanks to @Balthus1989 for reporting the issue.

• Fix recursive copying issue in Delegate provider. See issue: #245. Thanks to @GitterRemote for reporting the issue.

• Add docs and example for Factory.add_attributes() method.

• Remove legacy css file.

• Remove unittest2 test dependency.

• Implement context manager interface for resetting a singleton provider. See issue: #413. Thanks to @Arrowana for suggesting the improvement.

• Implement overriding interface to container provider. See issue: #415. Thanks to @wackazong for bringing up the use case.

• Fix async mode mode exception handling issue in Dependency provider. See issue: #409. Thanks to @wackazong for reporting the issue.

• Fix links to boto3 example.

• Add wiring injections into modules and class attributes. See issue: #411. Many thanks to @brunopereira27 for submitting the use case.

• Introduce wiring inspect filter to filter out flask.request and other local proxy objects from the inspection. See issue: #408. Many thanks to @bvanfleet for reporting the issue and help in finding the root cause.

• Add boto3 example.

• Add tests for .as_float() modifier usage with wiring.

• Make refactoring of wiring module and tests. See PR # #406. Thanks to @withshubh for the contribution: - Remove unused imports in tests. - Use literal syntax to create data structure in tests.

• Add integration with a static analysis tool DeepSource.

• Add wiring by string id.

• Improve error message for Dependency provider missing attribute.

• Amend docs and add another example for @containers.copy() decorator.

• Add application-multiple-containers-runtime-overriding example. This example demonstrates how to build application from multiple containers and override one container config from another one in the runtime. See issue: #207.

• Add attributes forwarding for the Dependency provider.

• Add docs on @containers.copy() decorator.

• Refactor @containers.copy() decorator.

• Refactor async mode support in containers module.

• Fix docs publishing.

• Fix a typo.

• Fix mistakenly processed awaitable objects in async mode. This bug has corrupted fastapi-redis example causing pool exhaustion. Thanks to @iliamir and Valery Komarov for finding and reporting the issue.

• Refactor async mode.

• Improve async mode exceptions handling.

• Fix double printing of exception when async resource initialization causes an error.

• Hotfix a bug with importing FastAPI Request. See issue: #398. Thanks to @tapm for reporting the bug.

• Add support of aliases for Configuration provider. See issue: #394. Thanks to @gtors for suggesting the feature.

• Pin sphinx version to hotfix docs build.

• Fix a typo in docs.

• Add method container.check_dependencies() to check if all container dependencies are defined. See issue: #383. Thanks to @shaunc for suggesting the feature.

• Add container name to the representation of the Dependency provider.

• Add docs cross-links between Singleton provider and "Reset container singletons" pages.

• Improve Dependency provider error message: when dependency is undefined, error message contains its name.

• Move docs on container "self" injections to "Providers" section.

• Refactor containers module.

• Add container "self" injections. See issue: #364. Thanks to @shaunc for suggesting the feature.