python-diskcache
python-diskcache copied to clipboard
Clarify optional None parameters in docstrings
π Description
Docstrings across the cache modules were overly strict about parameter types, omitting that several valuesβsuch as expire, tag, or directory could legitimately be None. This led to confusing type-hint warnings. The updated docstrings explicitly document optional None values throughout the core, fanout, Django cache, persistent cache, and recipe helpers, ensuring the documentation matches actual behavior.
β¨ Changes
- [x] π Bug fix (non-breaking change which fixes an issue)
- [ ] π¨ Refactor (non-breaking change which refactors the code base)
- [ ] π New feature (non-breaking change which adds functionality)
- [ ] π₯ Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [x] π Documentation update
- [ ] π Security update