From: Ilya V. Schurov <ilya@schurov.com>
Date: Sat, 11 Mar 2023 00:27:41 +0000 (+0100)
Subject: gh-88071: Update docstrings of dataclass' astuple and asdict (#101806)
X-Git-Tag: v3.12.0a7~209
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=767d3a8f6f2f94daa15ad3759d0ecdf4c009b7ab;p=thirdparty%2FPython%2Fcpython.git

gh-88071: Update docstrings of dataclass' astuple and asdict (#101806)

Update dataclasses.astuple and dataclasses.asdict docstrings to reflect that they deep copy objects in the field values.
---

diff --git a/Lib/dataclasses.py b/Lib/dataclasses.py
index 24f3779ebb8e..f4617b1dbdac 100644
--- a/Lib/dataclasses.py
+++ b/Lib/dataclasses.py
@@ -1281,7 +1281,7 @@ def asdict(obj, *, dict_factory=dict):
     If given, 'dict_factory' will be used instead of built-in dict.
     The function applies recursively to field values that are
     dataclass instances. This will also look into built-in containers:
-    tuples, lists, and dicts.
+    tuples, lists, and dicts. Other objects are copied with 'copy.deepcopy()'.
     """
     if not _is_dataclass_instance(obj):
         raise TypeError("asdict() should be called on dataclass instances")
@@ -1353,7 +1353,7 @@ def astuple(obj, *, tuple_factory=tuple):
     If given, 'tuple_factory' will be used instead of built-in tuple.
     The function applies recursively to field values that are
     dataclass instances. This will also look into built-in containers:
-    tuples, lists, and dicts.
+    tuples, lists, and dicts. Other objects are copied with 'copy.deepcopy()'.
     """
 
     if not _is_dataclass_instance(obj):