From a5eabc9a39c617475adb7eaee62de7566a995442 Mon Sep 17 00:00:00 2001 From: Shreyan Avigyan Date: Sun, 2 May 2021 21:13:50 +0530 Subject: bpo-43997: Add versionadded directives for to match_args, kw_only, and slots in dataclasses.dataclasses documentation (GH-25803) --- Doc/library/dataclasses.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index 87091ef..a27d09d 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 -- cgit v0.12