docs: add missing versionadded/versionchanged directives - #1344
Merged
Conversation
Audit every public module against git history and the changelog, and add the missing directives to docstrings and hand-written rst. Fix the 26.3 Requirement equality note to drop name normalization, which dates to 23.2. Assisted-by: ClaudeCode:claude-fable-5 Claude-Session: https://claude.ai/code/session_01APjLVjop3cW91hskgMNZFN
Assisted-by: ClaudeCode:claude-fable-5 Claude-Session: https://claude.ai/code/session_01APjLVjop3cW91hskgMNZFN
…ions Verified against packaging 25.0, which raised InvalidVersion where 26.0 returns False. Assisted-by: ClaudeCode:claude-fable-5 Claude-Session: https://claude.ai/code/session_01APjLVjop3cW91hskgMNZFN
henryiii
marked this pull request as ready for review
July 21, 2026 03:28
Add versionadded directives for the direct_url (26.1), pylock (26.0), dependency_groups (26.1), and ranges (26.3) modules. Assisted-by: ClaudeCode:claude-opus-4.8
notatallshaw
approved these changes
Jul 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Instead of adding things piecemeal (see #1343 and a lot of other small PRs), I did a sweep looking for versionadded/versionchanged based on git history. Close #597. I was hoping this would be complete, but #1331 at least is not included.
🤖 AI text below 🤖
Adds missing
versionadded/versionchangeddirectives across the public modules, found by auditing each module against git history (git tag --contains) and the changelog.metadata:Metadata/InvalidMetadata(23.2), 24.0 attribute behavior, PEP 639 fields (24.2), PEP 794 fields and RFC822 classes (26.0)utils: everything back tocanonicalize_version(17.1), including later parameter and behavior changestags: the 20.0 API plusplatform_tags(21.1), iOS (24.2), Android (25.0)specifiers: 26.0 prerelease/unparsable-version changes oncontains/filtermarkers:EvaluateContextandevaluate(context=)(25.0),UndefinedEnvironmentName→KeyError(26.3)version:major/minor/micro(20.0)requirements,pylock,errors,licensesAlso narrows the 26.3
Requirementequality note: name canonicalization dates to 23.2, so that directive now covers only extras and specifiers.Versions were cross-checked against tagged file states (accounting for the src-layout move, which breaks naive
git logon current paths).https://claude.ai/code/session_01APjLVjop3cW91hskgMNZFN