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
zhanfan-818 commentedon Nov 4, 2026
Hi — I'd like to take this one.
Plan: update the
local_cache_max_itemsdocstring inaws_lambda_powertools/utilities/idempotency/config.pyfrom 1024 to 256 (docstring only, no behaviour change), then runruff format --check,ruff checkand the idempotency unit tests before opening the PR.I'm working with an AI assistant on this; I'll say so in the PR and paste the commands and output I actually ran. Happy to wait for assignment.
zhanfan-818 commentedon Nov 4, 2026
My mistake — I missed that this was already assigned to @lechakrawarthy on 2026-11-01. Stepping back, no PR from me on this one. Sorry for the noise.