Update the dbm documentation #137919
Open
Update the dbm documentation #137919
+68
−41
Conversation
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
Unify documentation for all backends, enumerate all not implemented mapping methods, document particularities of implemented mapping methods.
There was a problem hiding this comment.
I reordered methods because they order was inconsistent between classes.
I am not sure whether it is worth to document clear() methods for gdbm and ndbm (they are the part of the mutable mapping protocol) or just add the versionchanged` directives.
We may add other not yet implemented methods (pop, popitem, values, update) in future, as some mapping methods were added in the past.
corona10
approved these changes
Aug 18, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Unify documentation for all backends, enumerate all not implemented mapping methods, document particularities of implemented mapping methods.
📚 Documentation preview 📚: https://cpython-previews--137919.org.readthedocs.build/