⬆️ dep-bump(python): 3.11+ (#75)

* ⬆️ dep-bump(python): 3.11+
* ➕ dep-add: optype
* 💥 boom: replace CanCopyReplace with CanReplace

Signed-off-by: nstarman <nstarman@users.noreply.github.com>

Author: nstarman

.github/workflows/ci.yml

@@ -38,7 +38,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13"]
         runs-on: [ubuntu-latest, macos-latest, windows-latest]
 
     steps:
@@ -61,14 +61,14 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
 
-  check_oldest:
+  test_oldest:
     name: Check Oldest Dependencies
     runs-on: ${{ matrix.runs-on }}
     needs: [format]
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10"]
+        python-version: ["3.11"]
         runs-on: [ubuntu-latest]
 
     steps:
@@ -92,7 +92,7 @@ jobs:
   status:
     name: CI Pass
     runs-on: ubuntu-latest
-    needs: [format, tests, check_oldest]
+    needs: [format, tests, test_oldest]
     if: always()
     steps:
       - name: All required jobs passed

.python-version

@@ -1 +1 @@
-3.10
+3.11

pyproject.toml

@@ -11,20 +11,23 @@ classifiers = [
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Topic :: Scientific/Engineering",
   "Typing :: Typed",
 ]
-dependencies = ["plum-dispatch>=2.5.1", "typing_extensions>=4.12.2"]
+dependencies = [
+  "optype>=0.16.0",
+  "plum-dispatch>=2.5.1",
+  "typing_extensions>=4.12.2",
+]
 description = "dataclass tools, extended by multiple dispatch"
 dynamic = ["version"]
 license.file = "LICENSE"
 name = "dataclassish"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 
 [project.urls]
 "Bug Tracker" = "https://github.com/GalacticDynamics/dataclassish/issues"
@@ -84,7 +87,7 @@ disallow_incomplete_defs = false
 disallow_untyped_defs    = false
 enable_error_code        = ["ignore-without-code", "redundant-expr", "truthy-bool"]
 files                    = ["src"]
-python_version           = "3.10"
+python_version           = "3.11"
 strict                   = true
 warn_unreachable         = true
 warn_unused_configs      = true

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/converters.py

@@ -27,13 +27,14 @@
     Any,
     ClassVar,
     Generic,
+    NotRequired,
     Protocol,
     TypedDict,
     TypeVar,
     cast,
     overload,
 )
-from typing_extensions import NotRequired, dataclass_transform
+from typing_extensions import dataclass_transform
 
 ArgT = TypeVar("ArgT")  # Input type
 RetT = TypeVar("RetT")  # Return type

src/dataclassish/_src/flag_compat.py

@@ -4,8 +4,7 @@
 
 from collections.abc import Iterable
 from dataclasses import Field
-from typing import Any, cast
-from typing_extensions import Never
+from typing import Any, Never, cast
 
 from plum import dispatch
 

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.
-
-        """