Simplify container override api

Author: maldoinc

README.md

@@ -432,7 +432,7 @@ Wireup decorators only collect metadata. Injectables are plain classes and funct
 Swap dependencies during tests with `container.override`:
 
 ```python
-with container.override.injectable(target=Database, new=in_memory_database):
+with container.override({Database: in_memory_database}):
     # Injectables that depend on Database will receive in_memory_database
     # for the duration of this context manager
     response = client.get("/users")

docs/pages/container.md

@@ -135,7 +135,7 @@ db_url = container.config.get("database_url")
 Substitute dependencies for testing. Access via `container.override`.
 
 ```python
-with container.override.injectable(target=Database, new=mock_db):
+with container.override({Database: mock_db}):
     ...  # All injections of Database use mock_db
 ```
 

docs/pages/getting_started.md

@@ -254,7 +254,7 @@ To substitute dependencies on targets such as views in a web application you can
 the fly.
 
 ```python
-with container.override.injectable(WeatherService, new=test_weather_service):
+with container.override({WeatherService: test_weather_service}):
     response = client.get("/weather/forecast")
 ```
 

docs/pages/integrations/aiohttp/index.md

@@ -149,10 +149,9 @@ def test_override(aiohttp_client):
         def greet(self, name: str) -> str:
             return f"Hi, {name}"
 
-    with get_app_container(app).override.injectable(
-        GreeterService,
-        new=DummyGreeter(),
-    ):
+    container = get_app_container(app)
+
+    with container.override({GreeterService: DummyGreeter()}):
         res = aiohttp_client.get("/greet?name=Test")
 ```
 

docs/pages/integrations/asgi/generic_asgi.md

@@ -80,9 +80,7 @@ def create_app():
 
 def test_override():
     app = create_app()
-    with app.state.container.override.injectable(
-        MyService, new=MyFakeService()
-    ):
+    with app.state.container.override({MyService: MyFakeService()}):
         ...
 ```
 

docs/pages/integrations/click/index.md

@@ -92,7 +92,7 @@ def test_random_number_command():
             return 4
 
     # Create test container with mocked service
-    with container.override.injectable(RandomService, new=MockRandomService()):
+    with container.override({RandomService: MockRandomService()}):
         runner = CliRunner()
         result = runner.invoke(cli, ["random-number"])
 

docs/pages/integrations/django/request_time_injection.md

@@ -101,4 +101,4 @@ Prefer `@inject` for request-time functions and `@inject_app` for non-request en
 See [Django Testing](testing.md) for endpoint tests and dependency overrides. These patterns are tested the same way:
 
 - call endpoints with `Client` or `AsyncClient`
-- use `get_app_container().override.injectable(...)` to inject fakes
+- use `get_app_container().override({...})` to inject fakes

docs/pages/integrations/django/testing.md

@@ -62,9 +62,9 @@ def test_override_http_endpoint():
             return f"Hi {name}"
 
     client = Client()
-    with get_app_container().override.injectable(
-        GreeterService, new=FakeGreeter()
-    ):
+    container = get_app_container()
+
+    with container.override({GreeterService: FakeGreeter()}):
         response = client.get("/greet/?name=World")
 
     assert response.status_code == 200
@@ -87,9 +87,9 @@ def test_override_command():
             return f"Hi {name}"
 
     out = StringIO()
-    with get_app_container().override.injectable(
-        GreeterService, new=FakeGreeter()
-    ):
+    container = get_app_container()
+
+    with container.override({GreeterService: FakeGreeter()}):
         call_command("greet", "--name=World", stdout=out)
 
     assert out.getvalue().strip() == "Hi World"
@@ -101,4 +101,4 @@ DRF and Ninja handlers should use `@inject` explicitly. Their tests follow the s
 
 - call endpoint via test client
 - assert response
-- use `override.injectable(...)` when needed
+- use `container.override({...})` when needed

docs/pages/integrations/fastapi/class_based_handlers.md

@@ -122,9 +122,9 @@ from wireup.integration.fastapi import get_app_container
 
 
 def test_user_handler(app):
-    with get_app_container(app).override.injectable(
-        UserProfileService, new=MockUserService()
-    ):
+    container = get_app_container(app)
+
+    with container.override({UserProfileService: MockUserService()}):
         # Start the client INSIDE the override block
         # The handler is initialized with the mock during startup
         with TestClient(app) as client:
@@ -133,11 +133,11 @@ def test_user_handler(app):
 
 ```python title="Don't"
 def test_user_handler_wrong(app):
+    container = get_app_container(app)
+
     # Handler has already been instantiated at startup.
     with TestClient(app) as client:
-        with get_app_container(app).override.injectable(
-            UserProfileService, new=MockUserService()
-        ):
+        with container.override({UserProfileService: MockUserService()}):
             client.get("/users/")
 ```
 

docs/pages/integrations/fastapi/request_time_injection.md

@@ -173,11 +173,11 @@ def test_require_auth_denied():
 
 
 def test_require_auth_allowed():
+    container = get_app_container(app)
+
     with TestClient(app) as client:
         # Override AuthService to return True
-        with get_app_container(app).override.injectable(
-            AuthService, new=MockAuthService(allow=True)
-        ):
+        with container.override({AuthService: MockAuthService(allow=True)}):
             response = client.get("/users")
             assert response.status_code == 200
 ```
@@ -193,8 +193,7 @@ def test_request_middleware_runs():
 
 !!! tip
 
-    Use `get_app_container(app).override.injectable()` to inject mocks and fakes during tests. This works for both route
-    decorators and middleware.
+    Use `get_app_container(app).override()` to inject mocks and fakes during tests. This works for both route decorators and middleware.
 
 ## Direct Container Access