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

Author: serhiy-storchaka

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

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:

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.