halfedge 0.8.1__py3-none-any.whl → 0.12.0__py3-none-any.whl

halfedge/__init__.py

@@ -1,4 +1,8 @@
-"""Allow modules to be imported from top-level."""
+"""Import functions into the package namespace.
+
+:author: Shay Hill
+:created: 2026-01-25
+"""
 
 from halfedge.half_edge_constructors import BlindHalfEdges
 from halfedge.half_edge_elements import Edge, Face, MeshElementBase, Vert

halfedge/half_edge_constructors.py

@@ -23,7 +23,7 @@ then passing that raw data to mesh_from_vr would create a mesh with 6 faces and
 from __future__ import annotations
 
 from contextlib import suppress
-from typing import TYPE_CHECKING, Any, TypeVar
+from typing import TYPE_CHECKING, Any, Self, TypeVar
 
 from paragraphs import par
 
@@ -37,8 +37,6 @@ if TYPE_CHECKING:
 
 _T = TypeVar("_T")
 
-_TBlindHalfEdges = TypeVar("_TBlindHalfEdges", bound="BlindHalfEdges")
-
 
 class BlindHalfEdges:
     """Half-edge structure with no lookups."""
@@ -191,11 +189,11 @@ class BlindHalfEdges:
 
     @classmethod
     def from_vlfi(
-        cls: type[_TBlindHalfEdges],
+        cls,
         vl: Sequence[Vert],
         fi: Iterable[tuple[int, ...]],
         hi: Iterable[tuple[int, ...]] | None = None,
-    ) -> _TBlindHalfEdges:
+    ) -> Self:
         """Create a set of half edges from a vertex list and face index.
 
         :param vl: (vertex list) a seq of vertices

halfedge/half_edge_elements.py

@@ -38,14 +38,15 @@ from __future__ import annotations
 
 from contextlib import suppress
 from itertools import count
-from typing import TYPE_CHECKING, Any, Callable, TypeVar
+from typing import TYPE_CHECKING, Any, Self, TypeVar
 
 from halfedge.type_attrib import Attrib, ContagionAttrib
 
 if TYPE_CHECKING:
+    from collections.abc import Callable
+
     from halfedge.half_edge_constructors import BlindHalfEdges
 
-_TMeshElem = TypeVar("_TMeshElem", bound="MeshElementBase")
 
 _T = TypeVar("_T")
 
@@ -141,7 +142,7 @@ class MeshElementBase:
         except AttributeError:
             return None
 
-    def merge_from(self: _TMeshElem, *elements: _TMeshElem) -> _TMeshElem:
+    def merge_from(self, *elements: Self) -> Self:
         """Fill in missing references from other elements.
 
         :param elements: elements to merge from
@@ -165,7 +166,7 @@ class MeshElementBase:
                 self.set_attrib(merged_attrib)
         return self
 
-    def split_from(self: _TMeshElem, element: _TMeshElem) -> _TMeshElem:
+    def split_from(self, element: Self) -> Self:
         """Pass attributes when dividing or altering elements.
 
         :param element: element to split from
@@ -182,7 +183,7 @@ class MeshElementBase:
                 self.set_attrib(splitted)
         return self
 
-    def __lt__(self: _TMeshElem, other: _TMeshElem) -> bool:
+    def __lt__(self, other: Self) -> bool:
         """Sort by sn.
 
         You'll want to be able to sort Verts at least to make a vlvi (vertex list,

halfedge/py.typed

@@ -1 +1,5 @@
-#
+""" This file is used to indicate to mypy that the package is typed.
+
+Do not delete this comment, because empty files choke
+some cloud drives on sync.
+"""

halfedge/type_attrib.py

@@ -61,7 +61,7 @@ When assigned to a Vert instance, these will be stored in the Vert instance's
 from __future__ import annotations
 
 from contextlib import suppress
-from typing import TYPE_CHECKING, Any, Generic, Literal, TypeVar
+from typing import TYPE_CHECKING, Any, Generic, Literal, Self, TypeVar
 
 from paragraphs import par
 
@@ -79,13 +79,13 @@ class StaticAttrib(Generic[_T]):
     merged or split.
     """
 
-    __slots__ = ("_mesh", "_value")
+    __slots__ = ("_mesh", "cached_value")
 
     def __new__(
-        cls: type[_TStaticAttrib],
+        cls,
         value: _T | None = None,
         mesh: BlindHalfEdges | None = None,
-    ) -> _TStaticAttrib:
+    ) -> Self:
         """Raise an exception if the attribute is not subclassed."""
         del value
         del mesh
@@ -98,7 +98,7 @@ class StaticAttrib(Generic[_T]):
         self, value: _T | None = None, mesh: BlindHalfEdges | None = None
     ) -> None:
         """Set value and mesh."""
-        self._value = value
+        self.cached_value = value
         self._mesh = mesh
 
     def copy_to_element(
@@ -109,7 +109,7 @@ class StaticAttrib(Generic[_T]):
         :param mesh: BlindHalfEdges instance to which attrib will be assigned.
         :return: Attrib instance
         """
-        return type(self)(self._value, mesh)
+        return type(self)(self.cached_value, mesh)
 
     @property
     def value(self) -> _T:
@@ -118,12 +118,12 @@ class StaticAttrib(Generic[_T]):
         :return: Value of the attribute
         :raises AttributeError: If no value is set and _infer_value fails
         """
-        if self._value is not None:
-            return self._value
+        if self.cached_value is not None:
+            return self.cached_value
         with suppress(NotImplementedError, ValueError):
             value = self._infer_value()
-            self._value = value
-            return self._value
+            self.cached_value = value
+            return self.cached_value
         msg = "no value set and failed to infer from 'self.mesh'"
         raise AttributeError(msg)
 
@@ -157,16 +157,16 @@ class StaticAttrib(Generic[_T]):
               implication here is that calculation *cannot* be deferred till after a
               merge.
             * The merged method sums areas of the merged triangles at the first and
-              subsequent mergers, so further triangle area calculations (which
-              wouldn't work on the merged shapes anyway) are not required.
+              subsequent mergers, so further triangle area calculations (which wouldn't
+              work on the merged shapes anyway) are not required.
 
         If you infer a value, cache it by setting self._value.
 
-        If you do not intend to infer values, raise an exception. This exception
-        should occur *before* an AttributeError is raised for a potentially missing
-        mesh attribute. It should be clear that _infer_value failed because there
-        is no provision for inferring this Attrib.value, *not* because the
-        user failed to set the Attrib property attribute.
+        If you do not intend to infer values, raise an exception. This exception should
+        occur *before* an AttributeError is raised for a potentially missing mesh
+        attribute. It should be clear that _infer_value failed because there is no
+        provision for inferring this Attrib.value, *not* because the user failed to set
+        the Attrib property attribute.
         """
         msg = par(
             f"""'{type(self).__name__}' has no provision for inferring a value from
@@ -175,31 +175,26 @@ class StaticAttrib(Generic[_T]):
         raise AttributeError(msg)
 
 
-_TStaticAttrib = TypeVar("_TStaticAttrib", bound=StaticAttrib[Any])
-
-
 class Attrib(Generic[_T]):
     """Base class for element attributes.
 
     MeshElementBase has methods set_attrib and get_attrib that will store Attrib
     instances in the MeshElemenBase.attrib dict. The Attrib class defines how these
-    attributes behave when mesh elements are merged and optionally allows a value
-    (e.g., edge length) to be inferred from the Attrib.element property when and if
-    needed, allowing us to cache (and potentially never access) slow attributes.
-
-    Do not overload `__init__` or `value`. For the most part, treat as an ABC with
-    abstract methods `merge`, `split`, and `_infer_value`--although the base methods
-    are marginally useful and instructive, so you will not need to overload both in
-    every case.
+    attributes behave when mesh elements are merged and optionally allows a value (e.g.,
+    edge length) to be inferred from the Attrib.element property when and if needed,
+    allowing us to cache (and potentially never access) slow attributes.
+
+    Do not overload `__init__` or `value`. Subclasses can override `merge`, `split`,
+    and `_infer_value` to customize behavior while inheriting all other functionality.
     """
 
-    __slots__ = ("_element", "_value")
+    __slots__ = ("_element", "cached_value")
 
     def __new__(
-        cls: type[_TAttrib],
+        cls,
         value: _T | None = None,
         element: MeshElementBase | None = None,
-    ) -> _TAttrib:
+    ) -> Self:
         """Raise an exception if the attribute is not subclassed."""
         del value
         del element
@@ -212,7 +207,7 @@ class Attrib(Generic[_T]):
         self, value: _T | None = None, element: MeshElementBase | None = None
     ) -> None:
         """Set value and element."""
-        self._value = value
+        self.cached_value = value
         self._element = element
 
     @property
@@ -222,12 +217,12 @@ class Attrib(Generic[_T]):
         :return: Value of the attribute
         :raises AttributeError: If no value is set and _infer_value fails
         """
-        if self._value is not None:
-            return self._value
+        if self.cached_value is not None:
+            return self.cached_value
         with suppress(NotImplementedError, ValueError):
             value = self._infer_value()
-            self._value = value
-            return self._value
+            self.cached_value = value
+            return self.cached_value
         msg = "no value set and failed to infer from 'self.element'"
         raise AttributeError(msg)
 
@@ -249,7 +244,7 @@ class Attrib(Generic[_T]):
         :param element: New element
         :return: Attrib instance
         """
-        return type(self)(self._value, element)
+        return type(self)(self.cached_value, element)
 
     @classmethod
     def merge(cls, *merge_from: _TAttrib | None) -> _TAttrib | None:
@@ -268,14 +263,15 @@ class Attrib(Generic[_T]):
         Attrib attributes are assumed None if not defined and are never defined
         if their value is None.
 
-        This base method will not merge attributes, which is desirable in some cases.
+        Override this method in subclasses to customize merge behavior. Default
+        implementation returns None (no merge), which is desirable in some cases.
         For example, a triangle circumcenter that will be meaningless when the
         triangle is merged.
         """
         _ = merge_from
         return None
 
-    def split(self: _TAttrib) -> _TAttrib | None:
+    def split(self) -> Self | None:
         """Define how attribute will be passed when dividing self.element.
 
         :return: Attrib instance or None
@@ -293,7 +289,9 @@ class Attrib(Generic[_T]):
         attribute is lazy (e.g., edge norm), you might want to unset _value for each
         piece of a split edge.
 
-        This base method will not pass an attribute when dividing or altering.
+        Override this method in subclasses to customize split behavior. Default
+        implementation returns None (no split), meaning the attribute will not be
+        passed when dividing or altering elements.
         """
         return None
 
@@ -320,11 +318,12 @@ class Attrib(Generic[_T]):
 
         If you infer a value, cache it by setting self._value.
 
-        If you do not intend to infer values, raise an exception. This exception
-        should occur *before* an AttributeError is raised for a potentially missing
-        element attribute. It should be clear that _infer_value failed because there
-        is no provision for inferring this Attrib.value, *not* because the
-        user failed to set the Attrib property attribute.
+        Override this method in subclasses to customize value inference. If you do
+        not intend to infer values, raise an exception. This exception should occur
+        *before* an AttributeError is raised for a potentially missing element
+        attribute. It should be clear that _infer_value failed because there is no
+        provision for inferring this Attrib.value, *not* because the user failed to
+        set the Attrib property attribute.
         """
         msg = par(
             f"""'{type(self).__name__}' has no provision for inferring a value from
@@ -348,10 +347,10 @@ class ContagionAttrib(Attrib[Literal[True]]):
     """
 
     def __new__(
-        cls: type[_TAttrib],
+        cls,
         value: Literal[True] | None = None,
         element: MeshElementBase | None = None,
-    ) -> _TAttrib:
+    ) -> Self:
         """Raise an exception if the attribute is not subclassed."""
         del value
         del element
@@ -381,7 +380,7 @@ class ContagionAttrib(Attrib[Literal[True]]):
             return attribs[0]
         return None
 
-    def split(self: _TAttrib) -> _TAttrib | None:
+    def split(self) -> Self | None:
         """Copy attribute to splits.
 
         :return: self
@@ -400,10 +399,10 @@ class IncompatibleAttrib(Attrib[_T]):
     """
 
     def __new__(
-        cls: type[_TAttrib],
+        cls,
         value: _T | None = None,
         element: MeshElementBase | None = None,
-    ) -> _TAttrib:
+    ) -> Self:
         """Raise an exception if the attribute is not subclassed."""
         del value
         del element
@@ -431,7 +430,7 @@ class IncompatibleAttrib(Attrib[_T]):
                 return None
         return merge_from[0]
 
-    def split(self: _TAttrib) -> _TAttrib | None:
+    def split(self) -> Self | None:
         """Pass the value on.
 
         :return: self
@@ -443,10 +442,10 @@ class NumericAttrib(Attrib[_T]):
     """Average merge_from values."""
 
     def __new__(
-        cls: type[_TAttrib],
+        cls,
         value: _T | None = None,
         element: MeshElementBase | None = None,
-    ) -> _TAttrib:
+    ) -> Self:
         """Raise an exception if the attribute is not subclassed."""
         del value
         del element
@@ -473,10 +472,10 @@ class Vector2Attrib(Attrib[tuple[float, float]]):
     """Average merge_from values as xy tuples."""
 
     def __new__(
-        cls: type[_TAttrib],
+        cls,
         value: tuple[float, float] | None = None,
         element: MeshElementBase | None = None,
-    ) -> _TAttrib:
+    ) -> Self:
         """Raise an exception if the attribute is not subclassed."""
         del value
         del element
@@ -496,7 +495,7 @@ class Vector2Attrib(Attrib[tuple[float, float]]):
         if not have_values:
             return None
         values = [x.value for x in have_values]
-        sum_x, sum_y = (sum(xs) for xs in zip(*values))
+        sum_x, sum_y = (sum(xs) for xs in zip(*values, strict=True))
         num = len(values)
         return type(have_values[0])((sum_x / num, sum_y / num))
 
@@ -505,10 +504,10 @@ class Vector3Attrib(Attrib[tuple[float, float, float]]):
     """Average merge_from values as xyz tuples."""
 
     def __new__(
-        cls: type[_TAttrib],
+        cls,
         value: tuple[float, float, float] | None = None,
         element: MeshElementBase | None = None,
-    ) -> _TAttrib:
+    ) -> Self:
         """Raise an exception if the attribute is not subclassed."""
         del value
         del element
@@ -528,6 +527,6 @@ class Vector3Attrib(Attrib[tuple[float, float, float]]):
         if not have_values:
             return None
         values = [x.value for x in have_values]
-        sum_x, sum_y, sum_z = (sum(xs) for xs in zip(*values))
+        sum_x, sum_y, sum_z = (sum(xs) for xs in zip(*values, strict=True))
         num = len(values)
         return type(have_values[0])((sum_x / num, sum_y / num, sum_z / num))

halfedge/validations.py

@@ -10,12 +10,12 @@ created: 181127
 from __future__ import annotations
 
 from itertools import chain
-from typing import TYPE_CHECKING, Any, Callable, TypeVar
+from typing import TYPE_CHECKING, Any, TypeVar
 
 from halfedge.half_edge_elements import Edge, Face, ManifoldMeshError
 
 if TYPE_CHECKING:
-    from collections.abc import Iterator
+    from collections.abc import Callable, Iterator
 
     from halfedge.half_edge_querries import StaticHalfEdges
 

{halfedge-0.8.1.dist-info → halfedge-0.12.0.dist-info}/METADATA

@@ -1,19 +1,13 @@
 Metadata-Version: 2.4
 Name: halfedge
-Version: 0.8.1
+Version: 0.12.0
 Summary: A typical half-edge data structure with some padding
+Author: Shay Hill
 Author-email: Shay Hill <shay_public@hotmail.com>
-License: MIT
-Requires-Python: >=3.9
+License-Expression: MIT
+Requires-Dist: paragraphs>=1.0.1
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: paragraphs
-Provides-Extra: dev
-Requires-Dist: commitizen; extra == "dev"
-Requires-Dist: coverage; extra == "dev"
-Requires-Dist: pre-commit; extra == "dev"
-Requires-Dist: pylint; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: tox; extra == "dev"
 
 # A typical halfedges data structure with some padding
 

halfedge-0.12.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+halfedge/__init__.py,sha256=1-q2fVFdMh3NWMh9ujuuyAnxNgPW8jIs_XpJ2oU8eFc,703
+halfedge/half_edge_constructors.py,sha256=mozSdN3fBh1EbjKnhR1g9tqePj2LwM6GL1OrUaBocos,8584
+halfedge/half_edge_elements.py,sha256=z5rjlZCVJJOpWUf8oVNvZXgr1x4xhz5033lmsm4UBLk,18466
+halfedge/half_edge_object.py,sha256=A70CVmV44zDi46gbtGHj8dw4Ltshqs56MRn5-78eM20,28771
+halfedge/half_edge_querries.py,sha256=q5xVOFdpw7t6fhs-Z8yF5j3RlG4DOrOgoLbBsAfkm4A,5179
+halfedge/py.typed,sha256=cnjZxaS4F-N8wLWhQK9YvZ-PaN5T1TK94E9VhPT_LGg,155
+halfedge/type_attrib.py,sha256=Giu4ck7shuq2xZoRrDjOMcOGty5v69Q49lo1kz7BJlU,20452
+halfedge/validations.py,sha256=G3YmJnxX5Q_C3Jhbd7740oTngvsOIllfSwLa81jY3d0,4544
+halfedge-0.12.0.dist-info/WHEEL,sha256=e_m4S054HL0hyR3CpOk-b7Q7fDX6BuFkgL5OjAExXas,80
+halfedge-0.12.0.dist-info/METADATA,sha256=T_3wiZ5N5tYrZy3v36L0sjyEVVDmGv8jWpnA4RdsUT4,6779
+halfedge-0.12.0.dist-info/RECORD,,

{halfedge-0.8.1.dist-info → halfedge-0.12.0.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: uv 0.9.27
 Root-Is-Purelib: true
 Tag: py3-none-any
-

halfedge-0.8.1.dist-info/RECORD

@@ -1,12 +0,0 @@
-halfedge/__init__.py,sha256=O5tfw3JIBJH83JlpwdYoTNHFsmcg959rAJd6RU51E4s,661
-halfedge/half_edge_constructors.py,sha256=0V9xsjPgoA0zKuqUSSLJI1WKhLDJAXHzVWwH2AHZcq4,8686
-halfedge/half_edge_elements.py,sha256=oX4ti6f6L1gcYsoP-KGNwdF4-cRpTJeBoMGMTJuIN14,18554
-halfedge/half_edge_object.py,sha256=A70CVmV44zDi46gbtGHj8dw4Ltshqs56MRn5-78eM20,28771
-halfedge/half_edge_querries.py,sha256=q5xVOFdpw7t6fhs-Z8yF5j3RlG4DOrOgoLbBsAfkm4A,5179
-halfedge/py.typed,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
-halfedge/type_attrib.py,sha256=NP8h5DmkSeq_v-wfueUumFeUKY94XqDoTQR9Lu8n094,20413
-halfedge/validations.py,sha256=8dDUf76t1_63_e0V5tRETHJDoYUUmjnSFgsULwSSKP4,4544
-halfedge-0.8.1.dist-info/METADATA,sha256=HITY6W4YbbBLTaGm68Iizy9tDtaMxmDyXj5gyYp4PKo,6996
-halfedge-0.8.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-halfedge-0.8.1.dist-info/top_level.txt,sha256=iqphKHiIR4DfFMs14-gkFOWTXVkRWfGmDZmCYHhuoFM,9
-halfedge-0.8.1.dist-info/RECORD,,

halfedge-0.8.1.dist-info/top_level.txt

@@ -1 +0,0 @@
-halfedge