Repository navigation
Docs: IdempotencyConfig docstring says local_cache_max_items defaults to 1024, it is 256 #8729
Description
Warning
For contributors, human or agent. Comment here to claim this issue and wait for the assignment before opening a PR; if two PRs show up, the assignee's stays. AI-assisted work is welcome, say so in the PR and tell us how you verified it: run the tests yourself and paste what you saw, do not describe runs you did not do. Read AGENTS.md first, it has the commands and the rules the CI enforces. This goes into 3.41.0.
Expected Behaviour
The IdempotencyConfig docstring states the real default for local_cache_max_items.
Current Behaviour
aws_lambda_powertools/utilities/idempotency/config.py declares local_cache_max_items: int = 256 and the documentation table says 256, but the docstring says "by default 1024".
Code snippet
from aws_lambda_powertools.utilities.idempotency import IdempotencyConfig
IdempotencyConfig().local_cache_max_items # 256, docstring says 1024Possible Solution
Fix the docstring line to 256. Docs-only change, use the docs(idempotency): prefix in the PR title.
Item 12 of the Idempotency audit in #8603. No tests or AWS resources needed.
Powertools for AWS Lambda (Python) version
latest
AWS Lambda function runtime
3.13
Packaging format used
PyPi
Debugging logs
No response
Activity
powertools-for-aws-oss-automation commentedon Oct 31, 2026
Note
For those interested in contributing, please leave a comment below so that we can assign the issue to you and make sure we don't duplicate efforts. If you have any further questions, please don't hesitate to ask below or on our Discord server.
lechakrawarthy commentedon Oct 31, 2026
Hi! I'd like to take this one. It's a small docstring fix (1024 -> 256). I'll wait for assignment before opening a PR.
leandrodamascena commentedon Oct 31, 2026
Go ahead @lechakrawarthy