geometrykit 0.6.0__tar.gz → 0.6.1__tar.gz

{geometrykit-0.6.0/python/geometrykit.egg-info → geometrykit-0.6.1}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: geometrykit
-Version: 0.6.0
+Version: 0.6.1
 Summary: Geometry primitives and NURBS data model — the geometry substrate for the ifckit family
 Author: Sander Boer
 License-Expression: LGPL-3.0-or-later
 Project-URL: Homepage, https://github.com/maucworks/geometrykit
 Project-URL: Changelog, https://github.com/maucworks/geometrykit/blob/master/CHANGELOG.md
+Project-URL: Documentation, https://maucworks.github.io/geometrykit/
 Keywords: geometry,nurbs,vector,curve,surface,splines
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -25,6 +26,7 @@ Provides-Extra: dev
 Requires-Dist: pytest<10,>=7; extra == "dev"
 Requires-Dist: pytest-cov<8,>=7; extra == "dev"
 Requires-Dist: hypothesis<8,>=6; extra == "dev"
+Requires-Dist: pdoc<17,>=15; python_version >= "3.10" and extra == "dev"
 Dynamic: license-file
 
 # geometrykit
@@ -36,6 +38,13 @@ fills with G1/G2 continuity options, plane × surface sections with
 pcurve tracks, and STEP/OBJ/STL writers. No OCCT, no compiled
 toolchain required to install.
 
+![Tests](https://github.com/maucworks/geometrykit/actions/workflows/tests.yml/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/geometrykit)
+[![Docs](https://img.shields.io/badge/docs-pdoc-blue)](https://maucworks.github.io/geometrykit/)
+
+API reference: **[maucworks.github.io/geometrykit](https://maucworks.github.io/geometrykit/)**
+(pdoc, generated from the docstrings)
+
 ## Install
 
 ```bash

{geometrykit-0.6.0 → geometrykit-0.6.1}/README.md

@@ -7,6 +7,13 @@ fills with G1/G2 continuity options, plane × surface sections with
 pcurve tracks, and STEP/OBJ/STL writers. No OCCT, no compiled
 toolchain required to install.
 
+![Tests](https://github.com/maucworks/geometrykit/actions/workflows/tests.yml/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/geometrykit)
+[![Docs](https://img.shields.io/badge/docs-pdoc-blue)](https://maucworks.github.io/geometrykit/)
+
+API reference: **[maucworks.github.io/geometrykit](https://maucworks.github.io/geometrykit/)**
+(pdoc, generated from the docstrings)
+
 ## Install
 
 ```bash

{geometrykit-0.6.0 → geometrykit-0.6.1}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "geometrykit"
-version = "0.6.0"
+version = "0.6.1"
 description = "Geometry primitives and NURBS data model — the geometry substrate for the ifckit family"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -40,11 +40,17 @@ dev = [
     "pytest>=7,<10",
     "pytest-cov>=7,<8",
     "hypothesis>=6,<8",
+    "pdoc>=15,<17; python_version >= '3.10'",
 ]
 
 [project.urls]
 Homepage = "https://github.com/maucworks/geometrykit"
 Changelog = "https://github.com/maucworks/geometrykit/blob/master/CHANGELOG.md"
+Documentation = "https://maucworks.github.io/geometrykit/"
+
+[tool.pdoc]
+search = true
+template_directory = "docs/pdoc_templates"
 
 [tool.setuptools.packages.find]
 where   = ["python"]

{geometrykit-0.6.0 → geometrykit-0.6.1}/python/geometrykit/__init__.py

@@ -21,7 +21,7 @@ from geometrykit.geometry import (
     Vec,
 )
 
-__version__ = "0.6.0"
+__version__ = "0.6.1"
 
 __all__ = [
     "__version__",

{geometrykit-0.6.0 → geometrykit-0.6.1}/python/geometrykit/geometry/frames.py

@@ -1,9 +1,8 @@
-# This file was generated with the assistance of an AI coding tool.
-# Ported from ifckit/ifckit/geometry/frames.py (LGPL-3.0-or-later heritage;
+# Promoted from ifckit/ifckit/geometry/frames.py (LGPL-3.0-or-later heritage;
 # ifckit is authored by the same copyright holder as geometrykit).
 """
-ifckit.geometry.frames
-======================
+geometrykit.geometry.frames
+===========================
 
 Transport frames, reference frames, and miter-scale computation for
 sweeping profiles along 3D spine paths.

{geometrykit-0.6.0 → geometrykit-0.6.1}/python/geometrykit/geometry/path.py

@@ -994,18 +994,29 @@ class Path:
             if isinstance(seg, Arc):  # safe: Arc never reloaded independently
                 return seg.normal
 
-        # For Lines only: use first segment direction and derive a perpendicular.
-        # isinstance is safe here — Line is a module-internal primitive,
-        # not a reloadable user class.
+        # For Lines only: normal from the first two non-parallel segments
+        # (the true path-plane normal). Collinear paths have no unique
+        # normal: fall back to an arbitrary perpendicular, against which
+        # a single straight line frames fine.
         if len(self._segments) > 0 and isinstance(
             self._segments[0], Line
         ):  # safe: Line never reloaded
-            first_dir = self._segments[0].direction.normalized()
-            # Return an arbitrary perpendicular to the line direction
-            if abs(first_dir.z) < 0.9:
-                return (Vec(0, 0, 1) ** first_dir).normalized()
-            else:
-                return (Vec(0, 1, 0) ** first_dir).normalized()
+            dirs = []
+            for seg in self._segments:
+                if isinstance(seg, Line):  # safe: Line never reloaded
+                    try:
+                        dirs.append(seg.direction.normalized())
+                    except ValueError:
+                        continue  # degenerate segment: no direction
+            if dirs:
+                ref = dirs[0]
+                for d in dirs[1:]:
+                    n = ref**d
+                    if n.length() > 1e-9:
+                        return n.normalized()
+                if abs(ref.z) < 0.9:
+                    return (Vec(0, 0, 1) ** ref).normalized()
+                return (Vec(0, 1, 0) ** ref).normalized()
 
         return None
 
@@ -1032,7 +1043,11 @@ class Path:
         # Ensure x_axis is perfectly orthogonal to normal (floating point safety).
         x_axis = x_axis - normal * (normal @ x_axis)
         x_axis = x_axis.normalized()
-        return Plane(origin, x_axis, normal)
+        # y_axis completes the right-handed frame so the plane normal
+        # (z_axis = x_axis x y_axis) equals the path normal. Passing
+        # `normal` as y_axis here would stand the plane edge-on to the path.
+        y_axis = normal**x_axis
+        return Plane(origin, x_axis, y_axis)
 
     @classmethod
     def assemble(

{geometrykit-0.6.0 → geometrykit-0.6.1/python/geometrykit.egg-info}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: geometrykit
-Version: 0.6.0
+Version: 0.6.1
 Summary: Geometry primitives and NURBS data model — the geometry substrate for the ifckit family
 Author: Sander Boer
 License-Expression: LGPL-3.0-or-later
 Project-URL: Homepage, https://github.com/maucworks/geometrykit
 Project-URL: Changelog, https://github.com/maucworks/geometrykit/blob/master/CHANGELOG.md
+Project-URL: Documentation, https://maucworks.github.io/geometrykit/
 Keywords: geometry,nurbs,vector,curve,surface,splines
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -25,6 +26,7 @@ Provides-Extra: dev
 Requires-Dist: pytest<10,>=7; extra == "dev"
 Requires-Dist: pytest-cov<8,>=7; extra == "dev"
 Requires-Dist: hypothesis<8,>=6; extra == "dev"
+Requires-Dist: pdoc<17,>=15; python_version >= "3.10" and extra == "dev"
 Dynamic: license-file
 
 # geometrykit
@@ -36,6 +38,13 @@ fills with G1/G2 continuity options, plane × surface sections with
 pcurve tracks, and STEP/OBJ/STL writers. No OCCT, no compiled
 toolchain required to install.
 
+![Tests](https://github.com/maucworks/geometrykit/actions/workflows/tests.yml/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/geometrykit)
+[![Docs](https://img.shields.io/badge/docs-pdoc-blue)](https://maucworks.github.io/geometrykit/)
+
+API reference: **[maucworks.github.io/geometrykit](https://maucworks.github.io/geometrykit/)**
+(pdoc, generated from the docstrings)
+
 ## Install
 
 ```bash

{geometrykit-0.6.0 → geometrykit-0.6.1}/python/geometrykit.egg-info/requires.txt

@@ -3,3 +3,6 @@
 pytest<10,>=7
 pytest-cov<8,>=7
 hypothesis<8,>=6
+
+[dev:python_version >= "3.10"]
+pdoc<17,>=15