[Python-checkins] bpo-43997: Add versionadded directives for to match_args, kw_only, and slots in dataclasses.dataclasses documentation (GH-25803)
miss-islington
webhook-mailer at python.org
Sun May 2 11:43:59 EDT 2021
https://github.com/python/cpython/commit/a5eabc9a39c617475adb7eaee62de7566a995442
commit: a5eabc9a39c617475adb7eaee62de7566a995442
branch: master
author: Shreyan Avigyan <shreyan.avigyan at gmail.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2021-05-02T08:43:50-07:00
summary:
bpo-43997: Add versionadded directives for to match_args, kw_only, and slots in dataclasses.dataclasses documentation (GH-25803)
files:
M Doc/library/dataclasses.rst
diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst
index 87091ef819d89..a27d09d0725de 100644
--- a/Doc/library/dataclasses.rst
+++ b/Doc/library/dataclasses.rst
@@ -168,6 +168,8 @@ Module-level decorators, classes, and functions
``__match_args__`` is already defined in the class, then
``__match_args__`` will not be generated.
+ .. versionadded:: 3.10
+
- ``kw_only``: If true (the default value is ``False``), then all
fields will be marked as keyword-only. If a field is marked as
keyword-only, then the only affect is that the :meth:`__init__`
@@ -177,11 +179,15 @@ Module-level decorators, classes, and functions
:term:`parameter` glossary entry for details. Also see the
``dataclasses.KW_ONLY`` section.
+ .. versionadded:: 3.10
+
- ``slots``: If true (the default is ``False``), :attr:`__slots__` attribute
will be generated and new class will be returned instead of the original one.
If :attr:`__slots__` is already defined in the class, then :exc:`TypeError`
is raised.
+ .. versionadded:: 3.10
+
``field``\s may optionally specify a default value, using normal
Python syntax::
@@ -267,6 +273,8 @@ Module-level decorators, classes, and functions
This is used when the generated :meth:`__init__` method's
parameters are computed.
+ .. versionadded:: 3.10
+
If the default value of a field is specified by a call to
:func:`field()`, then the class attribute for this field will be
replaced by the specified ``default`` value. If no ``default`` is
More information about the Python-checkins
mailing list