From 1ab3d5fec9179dbaa09b70bc51ae981a2b84538e Mon Sep 17 00:00:00 2001 From: hirenkumar-n-dholariya Date: Thu, 11 Jun 2026 18:29:12 -0400 Subject: [PATCH 1/2] docs(event-handler): add import path gotcha for dependency_overrides testing docs(event-handler): add import path gotcha for dependency_overrides testing Signed-off-by: hirenkumar-n-dholariya --- docs/core/event_handler/api_gateway.md | 27 ++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/docs/core/event_handler/api_gateway.md b/docs/core/event_handler/api_gateway.md index 076e2aa3c11..c4508976157 100644 --- a/docs/core/event_handler/api_gateway.md +++ b/docs/core/event_handler/api_gateway.md @@ -1459,6 +1459,33 @@ Use `dependency_overrides` to replace any dependency with a mock or stub during --8<-- "examples/event_handler_rest/src/dependency_injection_testing.py" ``` +???+ warning "Import path must match exactly when using dependency_overrides" + When using `dependency_overrides` in tests, the imported dependency reference must use the **exact same import path** as the handler file. Python treats differently-imported modules as different objects in `sys.modules`, so the override will be silently ignored otherwise. + + === "✅ Correct" + + ```python + # handler.py + from depends import get_config + + # test_handler.py - matches handler's import path exactly + from depends import get_config + + app.dependency_overrides[get_config] = lambda: "test-value" + ``` + + === "❌ Wrong" + + ```python + # handler.py + from depends import get_config + + # test_handler.py - different import path, override won't apply + from my_app.api_handler.depends import get_config + + app.dependency_overrides[get_config] = lambda: "test-value" + ``` + ???+ tip "Caching behavior" By default, dependencies are cached within the same invocation (`use_cache=True`). If the same dependency is used by multiple handlers or sub-dependencies, it is resolved once and the result is reused. Use `Depends(fn, use_cache=False)` to resolve every time. From 09984b3233e54724a6d2b3997a827496b172f4e6 Mon Sep 17 00:00:00 2001 From: hirenkumar-n-dholariya Date: Fri, 12 Jun 2026 07:16:26 -0400 Subject: [PATCH 2/2] docs(event-handler): add import path gotcha for dependency_overrides testing docs(event-handler): add import path gotcha for dependency_overrides testing Signed-off-by: hirenkumar-n-dholariya