mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-23 09:19:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

gh-130130: Clarify hash=False docs in dataclasses.field (#130324)

Browse source
This commit is contained in:
Sabfo 2025-02-20 09:43:27 +02:00 • committed by GitHub
parent 1b070060c0
commit 47ace53995
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 5 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/library/dataclasses.rst
View file

@ -270,10 +270,11 @@ Module contents
string returned by the generated :meth:`~object.__repr__` method.
- *hash*: This can be a bool or ``None``. If true, this field is
included in the generated :meth:`~object.__hash__` method. If ``None`` (the
default), use the value of *compare*: this would normally be
the expected behavior. A field should be considered in the hash
if it's used for comparisons. Setting this value to anything
included in the generated :meth:`~object.__hash__` method. If false,
this field is excluded from the generated :meth:`~object.__hash__`.
If ``None`` (the default), use the value of *compare*: this would
normally be the expected behavior, since a field should be included
in the hash if it's used for comparisons. Setting this value to anything
other than ``None`` is discouraged.
One possible reason to set ``hash=False`` but ``compare=True``