ducktools-classbuilder 0.8.4__py3-none-any.whl → 0.9.1__py3-none-any.whl

ducktools/classbuilder/__init__.py

@@ -47,7 +47,7 @@ _UNDER_TESTING = os.environ.get("PYTEST_VERSION") is not None
 # Obtain types the same way types.py does in pypy
 # See: https://github.com/pypy/pypy/blob/19d9fa6be11165116dd0839b9144d969ab426ae7/lib-python/3/types.py#L61-L73
 class _C: __slots__ = 's'  # noqa
-_MemberDescriptorType = type(_C.s)  # noqa
+_MemberDescriptorType = type(_C.s)  # type: ignore
 _MappingProxyType = type(type.__dict__)
 del _C
 
@@ -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})
@@ -961,24 +992,6 @@ def slotclass(cls=None, /, *, methods=default_methods, syntax_check=True):
     return cls
 
 
-class AnnotationClass(metaclass=SlotMakerMeta):
-    __slots__ = {}
-
-    def __init_subclass__(
-            cls,
-            methods=default_methods,
-            gatherer=unified_gatherer,
-            **kwargs
-    ):
-        # Check class dict otherwise this will always be True as this base
-        # class uses slots.
-        slots = "__slots__" in cls.__dict__
-
-        builder(cls, gatherer=gatherer, methods=methods, flags={"slotted": slots})
-        check_argument_order(cls)
-        super().__init_subclass__(**kwargs)
-
-
 @slotclass
 class GatheredFields:
     """

ducktools/classbuilder/__init__.pyi

@@ -5,7 +5,6 @@ import inspect
 
 from collections.abc import Callable
 from types import MappingProxyType
-from typing_extensions import dataclass_transform
 
 _py_type = type | str  # Alias for type hint values
 _CopiableMappings = dict[str, typing.Any] | MappingProxyType[str, typing.Any]
@@ -74,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: ...
 
@@ -82,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]
@@ -244,18 +245,6 @@ def slotclass(
 
 _gatherer_type = Callable[[type | _CopiableMappings], tuple[dict[str, Field], dict[str, typing.Any]]]
 
-
-@dataclass_transform(field_specifiers=(Field,))
-class AnnotationClass(metaclass=SlotMakerMeta):
-    __slots__: dict
-
-    def __init_subclass__(
-        cls,
-        methods: frozenset[MethodMaker] | set[MethodMaker] = default_methods,
-        gatherer: _gatherer_type = unified_gatherer,
-        **kwargs,
-    ) -> None: ...
-
 class GatheredFields:
     __slots__: dict[str, None]
 

ducktools/classbuilder/_version.py

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

ducktools/classbuilder/annotations.py

@@ -25,7 +25,7 @@ import sys
 class _LazyAnnotationLib:
     def __getattr__(self, item):
         global _lazyannotationlib
-        import annotationlib  # type: ignore - this is a Python 3.14 library
+        import annotationlib  # type: ignore
         _lazyannotationlib = annotationlib
         return getattr(annotationlib, item)
 

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,
 )
 
@@ -294,7 +294,7 @@ class Attribute(Field):
     """
     iter: bool = True
     serialize: bool = True
-    metadata: dict = Field(default=FIELD_NOTHING, default_factory=dict)
+    metadata: dict = Field(default=FIELD_NOTHING, default_factory=dict)  # type: ignore
 
 
 # noinspection PyShadowingBuiltins
@@ -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,
@@ -551,7 +553,7 @@ def _make_prefab(
 
 class Prefab(metaclass=SlotMakerMeta):
     _meta_gatherer = prefab_gatherer
-    __slots__ = {}
+    __slots__ = {}  # type: ignore
 
     # noinspection PyShadowingBuiltins
     def __init_subclass__(
@@ -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/prefab.pyi

@@ -4,7 +4,8 @@ from typing_extensions import dataclass_transform
 
 import inspect
 
-from collections.abc import Callable
+# Suppress weird pylance error
+from collections.abc import Callable  # type: ignore
 
 from . import (
     NOTHING,
@@ -58,36 +59,73 @@ class Attribute(Field):
         default: typing.Any | _NothingType = NOTHING,
         default_factory: typing.Any | _NothingType = NOTHING,
         type: type | _NothingType = NOTHING,
-        doc: str | None = None,
-        init: bool = True,
-        repr: bool = True,
-        compare: bool = True,
-        iter: bool = True,
-        kw_only: bool = False,
-        serialize: bool = True,
-        metadata: dict | None = None,
+        doc: str | None = ...,
+        init: bool = ...,
+        repr: bool = ...,
+        compare: bool = ...,
+        iter: bool = ...,
+        kw_only: bool = ...,
+        serialize: bool = ...,
+        metadata: dict | None = ...,
     ) -> None: ...
 
     def __repr__(self) -> str: ...
     def __eq__(self, other: Attribute | object) -> bool: ...
     def validate_field(self) -> None: ...
 
+@typing.overload
 def attribute(
     *,
-    default: typing.Any | _NothingType = NOTHING,
-    default_factory: typing.Any | _NothingType = NOTHING,
-    init: bool = True,
-    repr: bool = True,
-    compare: bool = True,
-    iter: bool = True,
-    kw_only: bool = False,
-    serialize: bool = True,
-    exclude_field: bool = False,
-    private: bool = False,
-    doc: str | None = None,
-    metadata: dict | None = None,
-    type: type | _NothingType = NOTHING,
-) -> Attribute: ...
+    default: _T,
+    default_factory: _NothingType = NOTHING,
+    init: bool = ...,
+    repr: bool = ...,
+    compare: bool = ...,
+    iter: bool = ...,
+    kw_only: bool = ...,
+    serialize: bool = ...,
+    exclude_field: bool = ...,
+    private: bool = ...,
+    doc: str | None = ...,
+    metadata: dict | None = ...,
+    type: type | _NothingType = ...,
+) -> _T: ...
+
+@typing.overload
+def attribute(
+    *,
+    default: _NothingType = NOTHING,
+    default_factory: Callable[[], _T],
+    init: bool = ...,
+    repr: bool = ...,
+    compare: bool = ...,
+    iter: bool = ...,
+    kw_only: bool = ...,
+    serialize: bool = ...,
+    exclude_field: bool = ...,
+    private: bool = ...,
+    doc: str | None = ...,
+    metadata: dict | None = ...,
+    type: type | _NothingType = ...,
+) -> _T: ...
+
+@typing.overload
+def attribute(
+    *,
+    default: _NothingType = NOTHING,
+    default_factory: _NothingType = NOTHING,
+    init: bool = ...,
+    repr: bool = ...,
+    compare: bool = ...,
+    iter: bool = ...,
+    kw_only: bool = ...,
+    serialize: bool = ...,
+    exclude_field: bool = ...,
+    private: bool = ...,
+    doc: str | None = ...,
+    metadata: dict | None = ...,
+    type: type | _NothingType = ...,
+) -> typing.Any: ...
 
 def prefab_gatherer(cls_or_ns: type | MappingProxyType) -> tuple[dict[str, Attribute], dict[str, typing.Any]]: ...
 
@@ -111,7 +149,8 @@ _T = typing.TypeVar("_T")
 # noinspection PyUnresolvedReferences
 @dataclass_transform(field_specifiers=(Attribute, attribute))
 class Prefab(metaclass=SlotMakerMeta):
-    _meta_gatherer: Callable[[type | _CopiableMappings], tuple[dict[str, Field], dict[str, typing.Any]]]
+    _meta_gatherer: Callable[[type | _CopiableMappings], tuple[dict[str, Field], dict[str, typing.Any]]] = ...
+    __slots__: dict[str, typing.Any] = ...
     def __init_subclass__(
         cls,
         init: bool = True,
@@ -199,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.8.4.dist-info → ducktools_classbuilder-0.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ducktools-classbuilder
-Version: 0.8.4
+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.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+ducktools/classbuilder/__init__.py,sha256=5vagbDiErapPudNG5-gP3yarlA6-q8IriMcRrAzBBr4,33433
+ducktools/classbuilder/__init__.pyi,sha256=6nEfVyeF1HE4YlvcNkFetACqMd1EObu3hYwoLYBbRNo,7796
+ducktools/classbuilder/_version.py,sha256=Ti7IekFg9SsQHXFYa9yzblMN29C0yL2OG6aLOfnSQOc,52
+ducktools/classbuilder/annotations.py,sha256=VEZsCM8lwfhaWrQi8dUOAkicYHxUHaSAyM-FzL34wXI,3583
+ducktools/classbuilder/annotations.pyi,sha256=c5vYtULdDgMYWtkzeYMsHIbmnEuT2Ru-nNZieWvYuQ4,247
+ducktools/classbuilder/prefab.py,sha256=RiVbESwFiPv3Y4PpclSZAwdwBomILbhGEF8XHAaDzW4,24643
+ducktools/classbuilder/prefab.pyi,sha256=_Tm2V97Udt3-WlbBRuOSt11PPYdw1TrFeSd4Mcs2EKM,6422
+ducktools/classbuilder/py.typed,sha256=la67KBlbjXN-_-DfGNcdOcjYumVpKG_Tkw-8n5dnGB4,8
+ducktools_classbuilder-0.9.1.dist-info/LICENSE,sha256=6Thz9Dbw8R4fWInl6sGl8Rj3UnKnRbDwrc6jZerpugQ,1070
+ducktools_classbuilder-0.9.1.dist-info/METADATA,sha256=45E7CeSoBEii1Tra1U16WUvcBepEQ4vCsay_y_2UinY,9687
+ducktools_classbuilder-0.9.1.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+ducktools_classbuilder-0.9.1.dist-info/top_level.txt,sha256=uSDLtio3ZFqdwcsMJ2O5yhjB4Q3ytbBWbA8rJREganc,10
+ducktools_classbuilder-0.9.1.dist-info/RECORD,,

ducktools_classbuilder-0.8.4.dist-info/RECORD

@@ -1,13 +0,0 @@
-ducktools/classbuilder/__init__.py,sha256=J0Tyf-IS7fCuNhccsVnLqnId83hHqffw5CW-gbHJza4,32831
-ducktools/classbuilder/__init__.pyi,sha256=47rT22Copd8gKiw26sTdAkA99NjMMwX6WsYsN0EEEtY,8060
-ducktools/classbuilder/_version.py,sha256=1lfD4M7j7FGjNEGzWx3WAlgJCS0G0L-UuzDObMBwmDo,52
-ducktools/classbuilder/annotations.py,sha256=kuL2ZJR3-mrN9XnWx88FC0rXgSwtT-C1EKbdZ_ijNzg,3615
-ducktools/classbuilder/annotations.pyi,sha256=c5vYtULdDgMYWtkzeYMsHIbmnEuT2Ru-nNZieWvYuQ4,247
-ducktools/classbuilder/prefab.py,sha256=GVoYmMVEBXWTwJRQsEUG1VfP_Kc3neHYFdwi7OCyOtg,24383
-ducktools/classbuilder/prefab.pyi,sha256=NoGeBiPvm3VismyOyVsz1mrKFUex90BU3fRcxh6o76E,5465
-ducktools/classbuilder/py.typed,sha256=la67KBlbjXN-_-DfGNcdOcjYumVpKG_Tkw-8n5dnGB4,8
-ducktools_classbuilder-0.8.4.dist-info/LICENSE,sha256=6Thz9Dbw8R4fWInl6sGl8Rj3UnKnRbDwrc6jZerpugQ,1070
-ducktools_classbuilder-0.8.4.dist-info/METADATA,sha256=4M21VREGfntX2daQyaalQBrehQIuSsOwsJwlRR_geYE,9636
-ducktools_classbuilder-0.8.4.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
-ducktools_classbuilder-0.8.4.dist-info/top_level.txt,sha256=uSDLtio3ZFqdwcsMJ2O5yhjB4Q3ytbBWbA8rJREganc,10
-ducktools_classbuilder-0.8.4.dist-info/RECORD,,