Skip to content

docs(event-handler): add import path gotcha for dependency_overrides testing#8269

Open
hirenkumar-n-dholariya wants to merge 3 commits into
aws-powertools:developfrom
hirenkumar-n-dholariya:fix/docs-depends-import-gotcha-8215
Open

docs(event-handler): add import path gotcha for dependency_overrides testing#8269
hirenkumar-n-dholariya wants to merge 3 commits into
aws-powertools:developfrom
hirenkumar-n-dholariya:fix/docs-depends-import-gotcha-8215

Conversation

@hirenkumar-n-dholariya

Copy link
Copy Markdown
Contributor

Issue number: fixes #8215

Summary

Add a warning callout in the "Testing with dependency overrides" section
explaining that the import path for dependency_overrides must exactly
match between the handler and test file.

Changes

Added ???+ warning admonition with ✅/❌ tabbed examples showing:

  • Correct usage: import path matches exactly between handler and test
  • Wrong usage: different import path causes override to be silently ignored

User experience

Before: Users encounter a non-obvious bug where dependency_overrides
silently has no effect when import paths don't match

After: Clear warning with examples explaining why import paths must
match exactly, helping users avoid this gotcha

Acknowledgment


By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

…testing

docs(event-handler): add import path gotcha for dependency_overrides testing

Signed-off-by: hirenkumar-n-dholariya <hirenkumarnd@gmail.com>
…testing

docs(event-handler): add import path gotcha for dependency_overrides testing

Signed-off-by: hirenkumar-n-dholariya <hirenkumarnd@gmail.com>
@hirenkumar-n-dholariya hirenkumar-n-dholariya requested a review from a team as a code owner June 12, 2026 11:18
@boring-cyborg boring-cyborg Bot added the documentation Improvements or additions to documentation label Jun 12, 2026
@powertools-for-aws-oss-automation powertools-for-aws-oss-automation Bot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Jun 12, 2026
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Depends import gotcha

1 participant