From: Shreyan Avigyan Date: Sun, 2 May 2021 15:43:50 +0000 (+0530) Subject: bpo-43997: Add versionadded directives for to match_args, kw_only, and slots in datac... X-Git-Tag: v3.10.0b1~33 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a5eabc9a39c617475adb7eaee62de7566a995442;p=thirdparty%2FPython%2Fcpython.git bpo-43997: Add versionadded directives for to match_args, kw_only, and slots in dataclasses.dataclasses documentation (GH-25803) --- diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index 87091ef819d8..a27d09d0725d 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