💥 boom: replace CanCopyReplace with CanReplace

Author: nstarman

src/dataclassish/__init__.py

@@ -19,7 +19,6 @@
     "field_items",
     # Classes
     "DataclassInstance",
-    "CanCopyReplace",
     "F",
 )
 
@@ -34,7 +33,7 @@
     get_field,
     replace,
 )
-from ._src.types import CanCopyReplace, DataclassInstance, F
+from ._src.types import DataclassInstance, F
 from ._version import version as __version__
 
 # Register dispatches by importing the submodules

src/dataclassish/_src/register_copyreplace.py

@@ -1,4 +1,4 @@
-"""Register dispatches for CanCopyReplace objects."""
+"""Register dispatches for CanReplace objects."""
 
 __all__: tuple[str, ...] = ()
 
@@ -7,17 +7,17 @@
 from collections.abc import Mapping
 from typing import Any
 
+import optype as opt
 from plum import dispatch
 
 from .register_base import _recursive_replace_helper
-from .types import CanCopyReplace
 
 # ===================================================================
 # Get field
 
 
 @dispatch
-def get_field(obj: CanCopyReplace, k: str, /) -> Any:
+def get_field(obj: opt.copy.CanReplaceSelf, k: str, /) -> Any:
     """Get a field of a dataclass instance by name.
 
     Examples:
@@ -65,7 +65,7 @@ def get_field(obj: CanCopyReplace, k: str, /) -> Any:
 
 
 @dispatch
-def replace(obj: CanCopyReplace, /, **kwargs: Any) -> CanCopyReplace:
+def replace(obj: opt.copy.CanReplaceSelf, /, **kwargs: Any) -> opt.copy.CanReplaceSelf:
     """Replace the fields of an object.
 
     Examples:
@@ -133,7 +133,9 @@ def replace(obj: CanCopyReplace, /, **kwargs: Any) -> CanCopyReplace:
 
 
 @dispatch  # type: ignore[no-redef]
-def replace(obj: CanCopyReplace, fs: Mapping[str, Any], /) -> CanCopyReplace:
+def replace(
+    obj: opt.copy.CanReplaceSelf, fs: Mapping[str, Any], /
+) -> opt.copy.CanReplaceSelf:
     """Replace the fields of a dataclass instance.
 
     Examples:

src/dataclassish/_src/types.py

@@ -1,10 +1,9 @@
 """Data types for ``dataclassish``."""
 
-__all__ = ("DataclassInstance", "CanCopyReplace", "F")
+__all__ = ("DataclassInstance", "F")
 
 from dataclasses import dataclass
 from typing import Any, ClassVar, Generic, Protocol, TypeVar, runtime_checkable
-from typing_extensions import Self
 
 
 @runtime_checkable
@@ -72,65 +71,3 @@ class F(Generic[V]):
     """
 
     value: V
-
-
-# ===================================================================
-
-
-@runtime_checkable
-class CanCopyReplace(Protocol):
-    """Protocol for objects that implement the ``__replace__`` method.
-
-    This is used by ``copy.replace`` (Python 3.13+) to replace fields of an
-    object.  This is a generalization of the ``dataclasses.replace`` function.
-
-    Examples
-    --------
-    >>> from dataclassish import CanCopyReplace
-
-    >>> class Point:
-    ...     def __init__(self, x, y):
-    ...         self.x = x
-    ...         self.y = y
-    ...     def __replace__(self, **changes):
-    ...         return Point(**(self.__dict__ | changes))
-    ...     def __repr__(self):
-    ...         return f"Point(x={self.x}, y={self.y})"
-
-    >>> issubclass(Point, CanCopyReplace)
-    True
-
-    >>> point = Point(1.0, 2.0)
-    >>> isinstance(point, CanCopyReplace)
-    True
-
-    The ``__replace__`` method was introduced in Python 3.13 to bring
-    ``dataclasses.replace``-like functionality to any implementing object. The
-    method is publicly exposed via the ``copy.replace`` function.
-
-    % invisible-code-block: python
-    %
-    % import sys
-
-    % skip: start if(sys.version_info < (3, 13), reason="py3.13+")
-
-    >>> import copy
-    >>> copy.replace(point, x=3.0)
-    Point(x=3.0, y=2.0)
-
-    % skip: end
-
-    """
-
-    def __replace__(self: Self, /, **changes: Any) -> Self:
-        """Replace the fields of the object.
-
-        This method should return a new object with the fields replaced.
-
-        Args:
-            **changes: Field names and their new values.
-
-        Returns:
-            A new object with the specified fields replaced.
-
-        """