ducktools-classbuilder 0.9.0__tar.gz → 0.9.1__tar.gz

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/.github/workflows/auto_test.yml

@@ -14,7 +14,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.14-dev", "3.13", "3.12", "3.11", "3.10", "pypy-3.10", "3.9", "3.8"]
+        python-version: ["3.14-dev", "3.13", "3.12", "3.11", "pypy-3.11", "3.10", "3.9", "3.8"]
 
     steps:
     - uses: actions/checkout@v4

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ducktools-classbuilder
-Version: 0.9.0
+Version: 0.9.1
 Summary: Toolkit for creating class boilerplate generators
 Author: David C Ellis
 Project-URL: Homepage, https://github.com/davidcellis/ducktools-classbuilder
@@ -11,6 +11,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: License :: OSI Approved :: MIT License
 Requires-Python: >=3.8

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/pyproject.toml

@@ -21,6 +21,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Operating System :: OS Independent",
     "License :: OSI Approved :: MIT License",
 ]
@@ -37,7 +38,10 @@ where = ["src"]
 
 [tool.setuptools_scm]
 version_file = "src/ducktools/classbuilder/_version.py"
-version_file_template = "__version__ = \"{version}\"\n__version_tuple__ = {version_tuple}\n"
+version_file_template = """
+__version__ = "{version}"
+__version_tuple__ = {version_tuple}
+"""
 
 [project.urls]
 "Homepage" = "https://github.com/davidcellis/ducktools-classbuilder"

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/src/ducktools/classbuilder/__init__.py

@@ -385,6 +385,36 @@ def eq_generator(cls, funcname="__eq__"):
     return GeneratedCode(code, globs)
 
 
+def replace_generator(cls, funcname="__replace__"):
+    # Generate the replace method for built classes
+    # unlike the dataclasses implementation this is generated
+    attribs = get_fields(cls)
+    
+    # This is essentially the as_dict generator for prefabs
+    # except based on attrib.init instead of .serialize
+    vals = ", ".join(
+        f"'{name}': self.{name}"
+        for name, attrib in attribs.items()
+        if attrib.init
+    )
+    init_dict = f"{{{vals}}}"
+
+    code = (
+        f"def {funcname}(self, /, **changes):\n"
+        f"    new_kwargs = {init_dict}\n"
+        f"    for name, value in changes.items():\n"
+        f"        if name not in new_kwargs:\n"    
+        f"            raise TypeError(\n"
+        f"                f\"{{name!r}} is not a valid replacable \"\n"
+        f"                f\"field on {{self.__class__.__name__!r}}\"\n"
+        f"            )\n"
+        f"        new_kwargs[name] = value\n"
+        f"    return self.__class__(**new_kwargs)\n"
+    )
+    globs = {}
+    return GeneratedCode(code, globs)
+
+
 def frozen_setattr_generator(cls, funcname="__setattr__"):
     globs = {}
     field_names = set(get_fields(cls))
@@ -433,6 +463,7 @@ def frozen_delattr_generator(cls, funcname="__delattr__"):
 init_maker = MethodMaker("__init__", init_generator)
 repr_maker = MethodMaker("__repr__", repr_generator)
 eq_maker = MethodMaker("__eq__", eq_generator)
+replace_maker = MethodMaker("__replace__", replace_generator)
 frozen_setattr_maker = MethodMaker("__setattr__", frozen_setattr_generator)
 frozen_delattr_maker = MethodMaker("__delattr__", frozen_delattr_generator)
 default_methods = frozenset({init_maker, repr_maker, eq_maker})

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/src/ducktools/classbuilder/__init__.pyi

@@ -73,6 +73,7 @@ def get_repr_generator(
 ) -> _CodegenType: ...
 def repr_generator(cls: type, funcname: str = "__repr__") -> GeneratedCode: ...
 def eq_generator(cls: type, funcname: str = "__eq__") -> GeneratedCode: ...
+def replace_generator(cls: type, funcname: str = "__replace__") -> GeneratedCode: ...
 
 def frozen_setattr_generator(cls: type, funcname: str = "__setattr__") -> GeneratedCode: ...
 
@@ -81,6 +82,7 @@ def frozen_delattr_generator(cls: type, funcname: str = "__delattr__") -> Genera
 init_maker: MethodMaker
 repr_maker: MethodMaker
 eq_maker: MethodMaker
+replace_maker: MethodMaker
 frozen_setattr_maker: MethodMaker
 frozen_delattr_maker: MethodMaker
 default_methods: frozenset[MethodMaker]

ducktools_classbuilder-0.9.1/src/ducktools/classbuilder/_version.py

@@ -0,0 +1,2 @@
+__version__ = "0.9.1"
+__version_tuple__ = (0, 9, 1)

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/src/ducktools/classbuilder/prefab.py

@@ -30,7 +30,7 @@ from . import (
     Field, MethodMaker, GatheredFields, GeneratedCode, SlotMakerMeta,
     builder, get_flags, get_fields,
     make_unified_gatherer,
-    frozen_setattr_maker, frozen_delattr_maker, eq_maker,
+    eq_maker, frozen_setattr_maker, frozen_delattr_maker, replace_maker,
     get_repr_generator,
 )
 
@@ -441,6 +441,8 @@ def _make_prefab(
     if dict_method:
         methods.add(asdict_maker)
 
+    methods.add(replace_maker)
+
     flags = {
         "kw_only": kw_only,
         "slotted": slotted,
@@ -779,3 +781,8 @@ def as_dict(o):
         for name, attrib in flds.items()
         if attrib.serialize
     }
+
+def replace(obj, /, **changes):
+    if not is_prefab_instance(obj):
+        raise TypeError("replace() should be called on prefab instances")
+    return obj.__replace__(**changes)

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/src/ducktools/classbuilder/prefab.pyi

@@ -238,3 +238,5 @@ def is_prefab(o: typing.Any) -> bool: ...
 def is_prefab_instance(o: object) -> bool: ...
 
 def as_dict(o) -> dict[str, typing.Any]: ...
+
+def replace(obj: _T, /, **changes: typing.Any) -> _T: ...

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/src/ducktools_classbuilder.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ducktools-classbuilder
-Version: 0.9.0
+Version: 0.9.1
 Summary: Toolkit for creating class boilerplate generators
 Author: David C Ellis
 Project-URL: Homepage, https://github.com/davidcellis/ducktools-classbuilder
@@ -11,6 +11,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: License :: OSI Approved :: MIT License
 Requires-Python: >=3.8

{ducktools_classbuilder-0.9.0 → ducktools_classbuilder-0.9.1}/src/ducktools_classbuilder.egg-info/SOURCES.txt

@@ -49,6 +49,7 @@ tests/test_slotmakermeta.py
 tests/annotations/test_annotated.py
 tests/annotations/test_annotations_module.py
 tests/annotations/test_future_annotations.py
+tests/prefab/test_replace.py
 tests/prefab/dynamic/test_compare_attrib.py
 tests/prefab/dynamic/test_construction.py
 tests/prefab/dynamic/test_frozen.py

ducktools_classbuilder-0.9.1/tests/prefab/test_replace.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import copy
+import sys
+
+import pytest
+
+from ducktools.classbuilder.prefab import (
+    Prefab, 
+    attribute, 
+    prefab, 
+    replace as prefab_replace,
+)
+
+
+replace_funcs = [prefab_replace]
+if sys.version_info >= (3, 13):  # 3.13 test against the copy version too
+    replace_funcs.append(copy.replace)  # type: ignore
+
+
+def ex_classes() -> tuple[type, type]:
+    @prefab
+    class ExDecorator:
+        a: int = 1
+        b: str = "Why?"
+        c: str = attribute(default="Non-replacable", init=False)
+
+    class ExBaseClass(Prefab):
+        a: int = 1
+        b: str = "Why?"
+        c: str = attribute(default="Non-replacable", init=False)
+
+    return ExDecorator, ExBaseClass
+
+example_classes = ex_classes()
+
+
+@pytest.mark.parametrize("replace", replace_funcs)
+@pytest.mark.parametrize("ex_class", example_classes)
+def test_replace_decorator(ex_class, replace):
+    ex = ex_class()
+
+    assert ex.a == 1
+    assert ex.b == "Why?"
+    assert ex.c == "Non-replacable"
+
+    ex_r = replace(ex, a=42)
+
+    assert ex != ex_r
+
+    assert ex_r.a == 42
+    assert ex_r.b == "Why?"
+    assert ex_r.c == "Non-replacable"
+
+
+@pytest.mark.parametrize("replace", replace_funcs)
+@pytest.mark.parametrize("ex_class", example_classes)
+def test_replace_fail(ex_class, replace):
+    ex = ex_class()
+
+    with pytest.raises(TypeError):
+        replace(ex, c="Fails")
+
+    with pytest.raises(TypeError):
+        replace(ex, d="Does Not Exist")

ducktools_classbuilder-0.9.0/src/ducktools/classbuilder/_version.py

@@ -1,2 +0,0 @@
-__version__ = "0.9.0"
-__version_tuple__ = (0, 9, 0)