halfedge 0.8.1__tar.gz → 0.11.0__tar.gz

{halfedge-0.8.1/src/halfedge.egg-info → halfedge-0.11.0}/PKG-INFO

@@ -1,19 +1,13 @@
 Metadata-Version: 2.4
 Name: halfedge
-Version: 0.8.1
+Version: 0.11.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.11.0/pyproject.toml

@@ -0,0 +1,92 @@
+[project]
+name = "halfedge"
+version = "0.11.0"
+description = "A typical half-edge data structure with some padding"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Shay Hill", email = "shay_public@hotmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "paragraphs>=1.0.1",
+]
+
+[build-system]
+requires = ["uv_build>=0.9.4,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "commitizen>=4.12.1",
+    "pre-commit>=4.5.1",
+    "pytest>=9.0.2",
+    "ruff>=0.14.14",
+]
+
+
+[tool.commitizen]
+kame = "cz_conventional_commits"
+version = "0.11.0"
+tag_format = "$version"
+major-version-zero = true
+version_files = ["pyproject.toml:^version"]
+
+
+[tool.isort]
+profile = "black"
+
+
+[tool.pytest.ini_options]
+addopts = "--doctest-modules"
+pythonpath = "tests"
+log_cli = true
+testpaths = ["tests"]
+norecursedirs = ["src", ".git", ".venv", "__pycache__", "*.egg"]
+
+
+[tool.ruff.lint.pydocstyle]
+convention = "pep257"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*.py" = [
+    "S101",
+    "D",
+    "F401",
+] # Ignore assertions, docstrings, unused imports in test files
+
+[tool.ruff.format]
+docstring-code-line-length = 88
+
+[tool.ruff.lint]
+
+select = ["ALL"]
+
+ignore = [
+    "PLR",  # magic values
+    "COM",  # trailing commas
+    "ANN",  # forbid Any
+    "S",    # warnings about pickle, random, etc.
+    "N",    # names
+    "B019", # memory leak warning for lru_cache
+]
+
+
+[tool.pyright]
+include = ["src"]
+exclude = ["**/__pycache__.py"]
+
+pythonVersion = "3.11"
+pythonPlatform = "All"
+
+typeCheckingMode = "strict"
+reportCallInDefaultInitializer = true
+reportImplicitStringConcatenation = true
+# reportMissingSuperCall = true
+reportPropertyTypeMismatch = true
+reportUninitializedInstanceVariable = true
+reportUnnecessaryTypeIgnoreComment = true
+reportUnusedCallResult = true
+
+venvPath = "."
+venv = "./.venv"

{halfedge-0.8.1 → halfedge-0.11.0}/src/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-0.8.1 → halfedge-0.11.0}/src/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-0.8.1 → halfedge-0.11.0}/src/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-0.11.0/src/halfedge/py.typed

@@ -0,0 +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-0.8.1 → halfedge-0.11.0}/src/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
 
@@ -82,10 +82,10 @@ class StaticAttrib(Generic[_T]):
     __slots__ = ("_mesh", "_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
@@ -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")
 
     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
@@ -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-0.8.1 → halfedge-0.11.0}/src/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/.github/workflows/pypi-project.yml

@@ -1,110 +0,0 @@
-# Run tests then upload to Pypi on version bumps.
-# Run tests on each push.
-# Try to bump version
-# If version is bumped, upload to pypi or test.pypi depending on branch name.
-
-name: pypi project
-
-on:
-  push:
-    branches: [dev, main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  tests:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
-        os: [ubuntu-latest, macos-latest, windows-latest]
-    # if: startsWith(github.event.head_commit.message, 'bump:') == false
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
-        python -m pip install pytest
-        python -m pip install commitizen
-        python -m pip install .
-
-    - name: Test with pytest
-      run: |
-        pytest
-
-  # # If the tests pass, try to bump the version number. If no bump is warranted,
-  # # pass silently.
-  # bump_version:
-  #   runs-on: ubuntu-latest
-  #   name: "Bump version and create changelog with commitizen"
-  #   continue-on-error: true
-  #   needs: [tests]
-  #   if: github.ref == 'refs/heads/dev'
-  #   steps:
-  #     - name: Check out
-  #       uses: actions/checkout@v4
-  #       with:
-  #         fetch-depth: 0
-  #         token: "${{ secrets.COMMITIZEN_BUMP }}"
-  #     - id: cz
-  #       name: Create bump and changelog
-  #       uses: commitizen-tools/commitizen-action@master
-  #       with:
-  #         github_token: ${{ secrets.COMMITIZEN_BUMP }}
-  #     - name: Print Version
-  #       run: echo "Bumped to version ${{ steps.cz.outputs.version }}"
-
-  # Deploy on test.pypi when branch is dev and commit message starts with 'bump'
-  deploy-on-testpypi:
-    runs-on: ubuntu-latest
-    continue-on-error: true
-    needs: [tests]
-    if: github.ref_name == 'dev' && startsWith(github.event.head_commit.message, 'bump:')
-    steps:
-      - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.x'
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install build
-      - name: Build package
-        run: python -m build
-      - name: Publish package
-        uses: pypa/gh-action-pypi-publish@27b31702a0e7fc50959f5ad993c78deac1bdfc29
-        with:
-          repository_url: https://test.pypi.org/legacy/
-          user: __token__
-          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
-
-  # Deploy on pypi when branch is main and commit message starts with 'bump'
-  deploy-on-pypi:
-    runs-on: ubuntu-latest
-    continue-on-error: true
-    needs: [tests]
-    if: github.ref_name == 'main' && startsWith(github.event.head_commit.message, 'bump:')
-    steps:
-      - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.x'
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install build
-      - name: Build package
-        run: python -m build
-      - name: Publish package
-        uses: pypa/gh-action-pypi-publish@27b31702a0e7fc50959f5ad993c78deac1bdfc29
-        with:
-          user: __token__
-          password: ${{ secrets.PYPI_API_TOKEN }}

halfedge-0.8.1/.gitignore

@@ -1 +0,0 @@
-Update-PythonVenv.ps1