anydi 0.64.0__tar.gz → 0.66.0__tar.gz

{anydi-0.64.0 → anydi-0.66.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anydi
-Version: 0.64.0
+Version: 0.66.0
 Summary: Dependency Injection library
 Keywords: dependency injection,dependencies,di,async,asyncio,application
 Author: Anton Ruhlov
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
 
 <div style="text-align: center;">
 
-Modern, lightweight Dependency Injection library using type annotations.
+Simple Dependency Injection library that uses Python type annotations.
 
 [![CI](https://github.com/antonrh/anydi/actions/workflows/ci.yml/badge.svg)](https://github.com/antonrh/anydi/actions/workflows/ci.yml)
 [![Coverage](https://codecov.io/gh/antonrh/anydi/branch/main/graph/badge.svg)](https://codecov.io/gh/antonrh/anydi)
@@ -53,21 +53,21 @@ http://anydi.readthedocs.io/
 
 ---
 
-`AnyDI` is a modern, lightweight Dependency Injection library suitable for any synchronous or asynchronous applications with Python 3.10+, based on type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
+`AnyDI` is a simple Dependency Injection library for Python 3.10+. It works with sync and async applications and uses type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
 
-The key features are:
+Main features:
 
-* **Type-safe**: Dependency resolution is driven by type hints.
-* **Async-ready**: Works the same for sync and async providers or injections.
-* **Scoped**: Built-in singleton, transient, and request scopes, plus custom scopes.
-* **Simple**: Small surface area keeps boilerplate low.
-* **Fast**: Has minimal overhead and resolves dependencies quickly.
-* **Named**: `Annotated[...]` makes multiple bindings per type simple.
-* **Managed**: Providers can open/close resources via context managers.
-* **Modular**: Compose containers or modules for large apps.
-* **Scanning**: Auto-discovers injectable callables.
-* **Integrated**: Extensions for popular frameworks.
-* **Testable**: Override providers directly in tests.
+* **Type-safe**: Uses type hints for dependency resolution.
+* **Async support**: Works with both sync and async code.
+* **Scopes**: Provides singleton, transient, and request scopes. Supports custom scope definitions.
+* **Simple**: Minimal boilerplate with straightforward API.
+* **Fast**: Low overhead dependency resolution.
+* **Named providers**: Use `Annotated[...]` for multiple providers per type.
+* **Resource management**: Context manager protocol support for lifecycle management.
+* **Modular**: Container and module composition for large applications.
+* **Auto-scan**: Automatic discovery of injectable callables.
+* **Framework integrations**: Extensions for popular frameworks.
+* **Testing**: Provider override mechanism for test isolation.
 
 ## Installation
 
@@ -266,23 +266,23 @@ urlpatterns = [
 ]
 ```
 
-## What's Next?
+## Learn More
 
-Ready to learn more? Check out these resources:
+Want to know more? Here are helpful resources:
 
 **Core Documentation:**
-- [Core Concepts](https://anydi.readthedocs.io/en/latest/concepts/) - Understand containers, providers, scopes, and dependency injection
-- [Providers](https://anydi.readthedocs.io/en/latest/usage/providers/) - Learn about registration, named providers, and resource management
-- [Scopes](https://anydi.readthedocs.io/en/latest/usage/scopes/) - Master lifecycle management with built-in and custom scopes
-- [Dependency Injection](https://anydi.readthedocs.io/en/latest/usage/injection/) - Explore injection patterns and techniques
-- [Testing](https://anydi.readthedocs.io/en/latest/usage/testing/) - Write testable code with provider overrides
+- [Core Concepts](https://anydi.readthedocs.io/en/latest/concepts/) - Learn about containers, providers, scopes, and dependency injection
+- [Providers](https://anydi.readthedocs.io/en/latest/usage/providers/) - How to register providers and manage resources
+- [Scopes](https://anydi.readthedocs.io/en/latest/usage/scopes/) - How to use built-in and custom scopes
+- [Dependency Injection](https://anydi.readthedocs.io/en/latest/usage/injection/) - Different ways to inject dependencies
+- [Testing](https://anydi.readthedocs.io/en/latest/usage/testing/) - How to test your code with provider overrides
 
 **Framework Integrations:**
-- [FastAPI](https://anydi.readthedocs.io/en/latest/extensions/fastapi/) - Build modern APIs with automatic dependency injection
-- [Django](https://anydi.readthedocs.io/en/latest/extensions/django/) - Integrate with Django and Django Ninja
-- [FastStream](https://anydi.readthedocs.io/en/latest/extensions/faststream/) - Message broker applications
-- [Typer](https://anydi.readthedocs.io/en/latest/extensions/typer/) - CLI applications with async support
-- [Pydantic Settings](https://anydi.readthedocs.io/en/latest/extensions/pydantic_settings/) - Configuration management
+- [FastAPI](https://anydi.readthedocs.io/en/latest/extensions/fastapi/) - How to use with FastAPI
+- [Django](https://anydi.readthedocs.io/en/latest/extensions/django/) - How to use with Django and Django Ninja
+- [FastStream](https://anydi.readthedocs.io/en/latest/extensions/faststream/) - How to use with message brokers
+- [Typer](https://anydi.readthedocs.io/en/latest/extensions/typer/) - How to use in CLI applications
+- [Pydantic Settings](https://anydi.readthedocs.io/en/latest/extensions/pydantic_settings/) - How to manage configuration
 
 **Full Documentation:**
-- [Read the Docs](https://anydi.readthedocs.io/) - Complete documentation with examples and guides
+- [Read the Docs](https://anydi.readthedocs.io/) - All documentation with examples and guides

{anydi-0.64.0 → anydi-0.66.0}/README.md

@@ -2,7 +2,7 @@
 
 <div style="text-align: center;">
 
-Modern, lightweight Dependency Injection library using type annotations.
+Simple Dependency Injection library that uses Python type annotations.
 
 [![CI](https://github.com/antonrh/anydi/actions/workflows/ci.yml/badge.svg)](https://github.com/antonrh/anydi/actions/workflows/ci.yml)
 [![Coverage](https://codecov.io/gh/antonrh/anydi/branch/main/graph/badge.svg)](https://codecov.io/gh/antonrh/anydi)
@@ -18,21 +18,21 @@ http://anydi.readthedocs.io/
 
 ---
 
-`AnyDI` is a modern, lightweight Dependency Injection library suitable for any synchronous or asynchronous applications with Python 3.10+, based on type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
+`AnyDI` is a simple Dependency Injection library for Python 3.10+. It works with sync and async applications and uses type annotations ([PEP 484](https://peps.python.org/pep-0484/)).
 
-The key features are:
+Main features:
 
-* **Type-safe**: Dependency resolution is driven by type hints.
-* **Async-ready**: Works the same for sync and async providers or injections.
-* **Scoped**: Built-in singleton, transient, and request scopes, plus custom scopes.
-* **Simple**: Small surface area keeps boilerplate low.
-* **Fast**: Has minimal overhead and resolves dependencies quickly.
-* **Named**: `Annotated[...]` makes multiple bindings per type simple.
-* **Managed**: Providers can open/close resources via context managers.
-* **Modular**: Compose containers or modules for large apps.
-* **Scanning**: Auto-discovers injectable callables.
-* **Integrated**: Extensions for popular frameworks.
-* **Testable**: Override providers directly in tests.
+* **Type-safe**: Uses type hints for dependency resolution.
+* **Async support**: Works with both sync and async code.
+* **Scopes**: Provides singleton, transient, and request scopes. Supports custom scope definitions.
+* **Simple**: Minimal boilerplate with straightforward API.
+* **Fast**: Low overhead dependency resolution.
+* **Named providers**: Use `Annotated[...]` for multiple providers per type.
+* **Resource management**: Context manager protocol support for lifecycle management.
+* **Modular**: Container and module composition for large applications.
+* **Auto-scan**: Automatic discovery of injectable callables.
+* **Framework integrations**: Extensions for popular frameworks.
+* **Testing**: Provider override mechanism for test isolation.
 
 ## Installation
 
@@ -231,23 +231,23 @@ urlpatterns = [
 ]
 ```
 
-## What's Next?
+## Learn More
 
-Ready to learn more? Check out these resources:
+Want to know more? Here are helpful resources:
 
 **Core Documentation:**
-- [Core Concepts](https://anydi.readthedocs.io/en/latest/concepts/) - Understand containers, providers, scopes, and dependency injection
-- [Providers](https://anydi.readthedocs.io/en/latest/usage/providers/) - Learn about registration, named providers, and resource management
-- [Scopes](https://anydi.readthedocs.io/en/latest/usage/scopes/) - Master lifecycle management with built-in and custom scopes
-- [Dependency Injection](https://anydi.readthedocs.io/en/latest/usage/injection/) - Explore injection patterns and techniques
-- [Testing](https://anydi.readthedocs.io/en/latest/usage/testing/) - Write testable code with provider overrides
+- [Core Concepts](https://anydi.readthedocs.io/en/latest/concepts/) - Learn about containers, providers, scopes, and dependency injection
+- [Providers](https://anydi.readthedocs.io/en/latest/usage/providers/) - How to register providers and manage resources
+- [Scopes](https://anydi.readthedocs.io/en/latest/usage/scopes/) - How to use built-in and custom scopes
+- [Dependency Injection](https://anydi.readthedocs.io/en/latest/usage/injection/) - Different ways to inject dependencies
+- [Testing](https://anydi.readthedocs.io/en/latest/usage/testing/) - How to test your code with provider overrides
 
 **Framework Integrations:**
-- [FastAPI](https://anydi.readthedocs.io/en/latest/extensions/fastapi/) - Build modern APIs with automatic dependency injection
-- [Django](https://anydi.readthedocs.io/en/latest/extensions/django/) - Integrate with Django and Django Ninja
-- [FastStream](https://anydi.readthedocs.io/en/latest/extensions/faststream/) - Message broker applications
-- [Typer](https://anydi.readthedocs.io/en/latest/extensions/typer/) - CLI applications with async support
-- [Pydantic Settings](https://anydi.readthedocs.io/en/latest/extensions/pydantic_settings/) - Configuration management
+- [FastAPI](https://anydi.readthedocs.io/en/latest/extensions/fastapi/) - How to use with FastAPI
+- [Django](https://anydi.readthedocs.io/en/latest/extensions/django/) - How to use with Django and Django Ninja
+- [FastStream](https://anydi.readthedocs.io/en/latest/extensions/faststream/) - How to use with message brokers
+- [Typer](https://anydi.readthedocs.io/en/latest/extensions/typer/) - How to use in CLI applications
+- [Pydantic Settings](https://anydi.readthedocs.io/en/latest/extensions/pydantic_settings/) - How to manage configuration
 
 **Full Documentation:**
-- [Read the Docs](https://anydi.readthedocs.io/) - Complete documentation with examples and guides
+- [Read the Docs](https://anydi.readthedocs.io/) - All documentation with examples and guides

{anydi-0.64.0 → anydi-0.66.0}/anydi/_container.py

@@ -553,6 +553,11 @@ class Container:
         )
 
         self._set_provider(provider)
+
+        # Clear cached resolvers when overriding
+        if override:
+            self._resolver.clear_caches()
+
         return provider
 
     def _validate_provider_scope(

{anydi-0.64.0 → anydi-0.66.0}/anydi/_resolver.py

@@ -62,6 +62,13 @@ class Resolver:
     def add_unresolved(self, interface: Any) -> None:
         self._unresolved_interfaces.add(interface)
 
+    def clear_caches(self) -> None:
+        """Clear all cached resolvers."""
+        self._cache.clear()
+        self._async_cache.clear()
+        self._override_cache.clear()
+        self._async_override_cache.clear()
+
     def get_cached(self, interface: Any, *, is_async: bool) -> CompiledResolver | None:
         """Get cached resolver if it exists."""
         if self.override_mode:
@@ -83,9 +90,14 @@ class Resolver:
             return cache[provider.interface]
 
         # Recursively compile dependencies first
-        for p in provider.parameters:
-            if p.provider is not None:
-                self.compile(p.provider, is_async=is_async)
+        for param in provider.parameters:
+            if param.provider is not None:
+                # Look up the current provider to handle overrides
+                current_provider = self._container.providers.get(param.annotation)
+                if current_provider is not None:
+                    self.compile(current_provider, is_async=is_async)
+                else:
+                    self.compile(param.provider, is_async=is_async)
 
         # Compile the resolver and creator functions
         compiled = self._compile_resolver(
@@ -155,23 +167,29 @@ class Resolver:
             else (self._async_cache if is_async else self._cache)
         )
 
-        for idx, p in enumerate(provider.parameters):
-            param_annotations[idx] = p.annotation
-            param_defaults[idx] = p.default
-            param_has_default[idx] = p.has_default
-            param_names[idx] = p.name
-            param_shared_scopes[idx] = p.shared_scope
-
-            if p.provider is not None:
-                compiled = cache.get(p.provider.interface)
+        for idx, param in enumerate(provider.parameters):
+            param_annotations[idx] = param.annotation
+            param_defaults[idx] = param.default
+            param_has_default[idx] = param.has_default
+            param_names[idx] = param.name
+            param_shared_scopes[idx] = param.shared_scope
+
+            if param.provider is not None:
+                # Look up the current provider from the container to handle overrides
+                current_provider = self._container.providers.get(param.annotation)
+                if current_provider is not None:
+                    compiled = cache.get(current_provider.interface)
+                else:
+                    # Fallback to the original provider if not in container
+                    compiled = cache.get(param.provider.interface)
                 if compiled is None:
-                    compiled = self.compile(p.provider, is_async=is_async)
-                    cache[p.provider.interface] = compiled
+                    compiled = self.compile(param.provider, is_async=is_async)
+                    cache[param.provider.interface] = compiled
                 param_resolvers[idx] = compiled.resolve
 
             unresolved_message = (
-                f"You are attempting to get the parameter `{p.name}` with the "
-                f"annotation `{type_repr(p.annotation)}` as a dependency into "
+                f"You are attempting to get the parameter `{param.name}` with the "
+                f"annotation `{type_repr(param.annotation)}` as a dependency into "
                 f"`{type_repr(provider.call)}` which is not registered or set in the "
                 "scoped context."
             )

{anydi-0.64.0 → anydi-0.66.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anydi"
-version = "0.64.0"
+version = "0.66.0"
 description = "Dependency Injection library"
 authors = [{ name = "Anton Ruhlov", email = "antonruhlov@gmail.com" }]
 requires-python = ">=3.10.0, <3.15"