https://github.com/python/cpython/commit/8b62374b344f5da852bed9f16619736d4d43936b
commit: 8b62374b344f5da852bed9f16619736d4d43936b
branch: main
author: sobolevn <m...@sobolevn.me>
committer: sobolevn <m...@sobolevn.me>
date: 2025-04-07T17:46:47+03:00
summary:
gh-132221: Fix `__match_args__` generation docs in `dataclasses.rst` (#132222)
files:
M Doc/library/dataclasses.rst
diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst
index f63a01e9570791..0bc171da4eefc7 100644
--- a/Doc/library/dataclasses.rst
+++ b/Doc/library/dataclasses.rst
@@ -164,7 +164,7 @@ Module contents
- *match_args*: If true (the default is ``True``), the
:attr:`~object.__match_args__` tuple will be created from the list of
- parameters to the generated :meth:`~object.__init__` method (even if
+ non keyword-only parameters to the generated :meth:`~object.__init__`
method (even if
:meth:`!__init__` is not generated, see above). If false, or if
:attr:`!__match_args__` is already defined in the class, then
:attr:`!__match_args__` will not be generated.
@@ -175,11 +175,12 @@ Module contents
fields will be marked as keyword-only. If a field is marked as
keyword-only, then the only effect is that the :meth:`~object.__init__`
parameter generated from a keyword-only field must be specified
- with a keyword when :meth:`!__init__` is called. There is no
- effect on any other aspect of dataclasses. See the
- :term:`parameter` glossary entry for details. Also see the
+ with a keyword when :meth:`!__init__` is called. See the :term:`parameter`
+ glossary entry for details. Also see the
:const:`KW_ONLY` section.
+ Keyword-only fields are not included in :attr:`!__match_args__`.
+
.. versionadded:: 3.10
- *slots*: If true (the default is ``False``), :attr:`~object.__slots__`
attribute
@@ -299,6 +300,8 @@ Module contents
This is used when the generated :meth:`~object.__init__` method's
parameters are computed.
+ Keyword-only fields are also not included in :attr:`!__match_args__`.
+
.. versionadded:: 3.10
- ``doc``: optional docstring for this field.
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
