bpo-37163: Make the obj argument of dataclasses.replace() a positional-only. (GH-14390)

serhiy-storchaka · web-flow · commit 2d88e63bfcf7 · 2019-06-26T19:07:44.000+03:00
diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst
@@ -356,7 +356,7 @@ Module-level decorators, classes, and functions
          def add_one(self):
              return self.x + 1
 
-.. function:: replace(instance, **changes)
+.. function:: replace(instance, /, **changes)
 
    Creates a new object of the same type of ``instance``, replacing
    fields with values from ``changes``.  If ``instance`` is not a Data
diff --git a/Lib/dataclasses.py b/Lib/dataclasses.py
@@ -1206,7 +1206,7 @@ class C(Base):
                      unsafe_hash=unsafe_hash, frozen=frozen)
 
 
-def replace(obj, **changes):
+def replace(obj, /, **changes):
     """Return a new object replacing specified fields with new values.
 
     This is especially useful for frozen classes.  Example usage:
diff --git a/Misc/NEWS.d/next/Library/2019-06-19-10-35-53.bpo-37163.9pPg2F.rst b/Misc/NEWS.d/next/Library/2019-06-19-10-35-53.bpo-37163.9pPg2F.rst
@@ -0,0 +1 @@
+The *obj* argument of :func:`dataclasses.replace` is positional-only now.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+The obj argument of :func:`dataclasses.replace` is positional-only now.