machinevision-toolbox-python 2.2.0__tar.gz → 2.3.0__tar.gz

machinevision_toolbox_python-2.3.0/.githooks/pre-commit

@@ -0,0 +1,83 @@
+#!/usr/bin/env python3
+"""Pre-commit hook: keep notebook outputs clear and bootstrap cells in sync.
+
+Activated once per machine via `git config core.hooksPath .githooks`
+(see docs/notebooks/README.md for the full explanation). Fixes any affected
+notebook in place and re-stages it, so the commit proceeds with the fix already
+applied -- no interruption, no separate re-commit step.
+"""
+
+import subprocess
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+NOTEBOOKS_DIR = REPO_ROOT / "docs" / "notebooks"
+
+
+def staged_files(pattern: str) -> list[str]:
+    result = subprocess.run(
+        ["git", "diff", "--cached", "--name-only", "--diff-filter=ACMR", "--", pattern],
+        cwd=REPO_ROOT,
+        capture_output=True,
+        text=True,
+        check=True,
+    )
+    return [line for line in result.stdout.splitlines() if line]
+
+
+def main() -> int:
+    if not NOTEBOOKS_DIR.exists():
+        return 0
+
+    staged_notebooks = staged_files("docs/notebooks/*.ipynb")
+    template_staged = bool(staged_files("docs/notebooks/_mvtb_nb_bootstrap.py"))
+
+    # Output-clearing only ever touches notebooks actually staged for this commit.
+    output_targets = staged_notebooks
+
+    # Bootstrap-cell regeneration also has to cover every notebook when the
+    # template itself changed -- otherwise the other notebooks go stale and CI
+    # fails on files this commit never touched.
+    if template_staged:
+        bootstrap_targets = sorted(
+            str(p.relative_to(REPO_ROOT)) for p in NOTEBOOKS_DIR.glob("*.ipynb")
+        )
+    else:
+        bootstrap_targets = staged_notebooks
+
+    if not output_targets and not bootstrap_targets:
+        return 0
+
+    changed_paths: set[str] = set()
+
+    try:
+        if output_targets:
+            paths = [str(REPO_ROOT / t) for t in output_targets]
+            subprocess.run(
+                [sys.executable, str(NOTEBOOKS_DIR / "clear_outputs.py"), *paths],
+                cwd=REPO_ROOT,
+                check=True,
+            )
+            changed_paths.update(paths)
+
+        if bootstrap_targets:
+            paths = [str(REPO_ROOT / t) for t in bootstrap_targets]
+            subprocess.run(
+                [sys.executable, str(NOTEBOOKS_DIR / "sync_bootstrap.py"), *paths],
+                cwd=REPO_ROOT,
+                check=True,
+            )
+            changed_paths.update(paths)
+    except subprocess.CalledProcessError:
+        print("pre-commit hook: notebook cleanup failed unexpectedly", file=sys.stderr)
+        return 1
+
+    if changed_paths:
+        subprocess.run(["git", "add", "--", *sorted(changed_paths)], cwd=REPO_ROOT, check=True)
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{machinevision_toolbox_python-2.2.0 → machinevision_toolbox_python-2.3.0}/.gitignore

@@ -9,6 +9,7 @@ dependencies*
 *.bag
 # but keep test fixtures
 !mvtb-data/mvtbdata/data/*.bag
+bags
 
 # old notebooks
 notebooks/old/*
@@ -94,3 +95,6 @@ docs/source/stubs/*
 
 # LLVM profiling data
 *.profraw
+
+### Node ###
+node_modules/

machinevision_toolbox_python-2.3.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+    ".": "2.3.0"
+}

{machinevision_toolbox_python-2.2.0 → machinevision_toolbox_python-2.3.0}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [2.3.0](https://github.com/petercorke/machinevision-toolbox-python/compare/v2.2.0...v2.3.0) (2026-08-13)
+
+**Highlight: Notebooks working in all environments** Fixed a number of problems with getting notebooks to execute in desktop Jupyter, Colab, and
+JupyterLite in browser.  Created nice framework to keep the environment-specific import logic in each notebook consistent at commit time.  Added
+CI tests and also CI check that notebooks runs in the pyodide environment.  Currently pinning to pyodide 0.6.1 to sidestep the lack of JSPI support
+in Safari and Firefox required by later pyodide kernels.
+
+
+### Features
+
+* **ci:** add a real-Pyodide dependency-completeness check for JupyterLite ([9072da6](https://github.com/petercorke/machinevision-toolbox-python/commit/9072da6e945b45bf2f04a5994f9dbc9c6d99622d))
+* **notebooks:** add shared environment-bootstrap module and drift-check tooling ([44242e8](https://github.com/petercorke/machinevision-toolbox-python/commit/44242e81420e05d2d5656c81c53a33f1071ddac7))
+* **notebooks:** migrate all notebooks to the generated bootstrap cell ([75f230c](https://github.com/petercorke/machinevision-toolbox-python/commit/75f230ce7d789e25edcd06694e886e0f4db8a83d))
+
+
+### Bug Fixes
+
+* **ci:** guard release-please's PyPI-publish trigger against the truthy-string bug ([#74](https://github.com/petercorke/machinevision-toolbox-python/issues/74)) ([0d74276](https://github.com/petercorke/machinevision-toolbox-python/commit/0d742769d2553125a5b2a08a4a8a16f1e9b9f69c))
+* **ci:** pass --repo to gh calls in release-please's PyPI-publish trigger ([#73](https://github.com/petercorke/machinevision-toolbox-python/issues/73)) ([6ff01a3](https://github.com/petercorke/machinevision-toolbox-python/commit/6ff01a395402d6363ade8b4f4e07952237089666))
+* **docs:** pin jupyterlite-pyodide-kernel==0.6.1, matching RTB and bdsim ([76bd7e1](https://github.com/petercorke/machinevision-toolbox-python/commit/76bd7e130dab5562bb947be9a6b6c1ef3a5e2140))
+* **notebooks:** fix JupyterLite bugs found via real-browser testing ([3979404](https://github.com/petercorke/machinevision-toolbox-python/commit/3979404b317a79f2769007a02ff7a24091e1e4b7))
+* release-please never triggered the actual PyPI publish ([18cc08b](https://github.com/petercorke/machinevision-toolbox-python/commit/18cc08bc21e38bef2f5ed56e31daee4c9404732a))
+
+
+### Documentation
+
+* **readme:** move to standard badge layout ([0722f9d](https://github.com/petercorke/machinevision-toolbox-python/commit/0722f9da96c97e2d49e791fd68237063df8d38cf))
+
 ## [2.2.0](https://github.com/petercorke/machinevision-toolbox-python/compare/v2.1.0...v2.2.0) (2026-08-10)
 
 **Highlight: OpenCV 5 compatibility.** MVTB now works correctly under both OpenCV 4 and the

{machinevision_toolbox_python-2.2.0 → machinevision_toolbox_python-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: machinevision-toolbox-python
-Version: 2.2.0
+Version: 2.3.0
 Summary: Object-oriented machine vision for Python.
 Project-URL: Homepage, https://github.com/petercorke/machinevision-toolbox-python
 Project-URL: Bug Tracker, https://github.com/pypa/sampleproject/issues
@@ -99,20 +99,24 @@ Description-Content-Type: text/markdown
 
 ---
 
-### Status & Ecosystem
-[![A Python Robotics Package](https://raw.githubusercontent.com/petercorke/robotics-toolbox-python/master/.github/svg/py_collection.min.svg)](https://github.com/petercorke/robotics-toolbox-python)
-[![QUT Centre for Robotics Open Source](https://github.com/qcr/qcr.github.io/raw/master/misc/badge.svg)](https://qcr.github.io)
+### Status & Project Health
+
 [![Build Status](https://github.com/petercorke/machinevision-toolbox-python/actions/workflows/ci.yml/badge.svg)](https://github.com/petercorke/machinevision-toolbox-python/actions/workflows/ci.yml)
-[![Coverage](https://codecov.io/gh/petercorke/machinevision-toolbox-python/branch/main/graph/badge.svg)](https://codecov.io/gh/petercorke/machinevision-toolbox-python)
+[![Downloads](https://static.pepy.tech/badge/machinevision-toolbox-python/month)](https://pepy.tech/projects/machinevision-toolbox-python)
 ![Python Version](https://img.shields.io/pypi/pyversions/machinevision-toolbox-python.svg)
+[![Coverage](https://codecov.io/gh/petercorke/machinevision-toolbox-python/branch/main/graph/badge.svg)](https://codecov.io/gh/petercorke/machinevision-toolbox-python)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![PyPI - Downloads](https://img.shields.io/pypi/dw/machinevision-toolbox-python)](https://pypistats.org/packages/machinevision-toolbox-python)
 
-### Powered by
-[![Powered by Spatial Maths](https://raw.githubusercontent.com/petercorke/spatialmath-python/master/.github/svg/sm_powered.min.svg)](https://github.com/petercorke/spatialmath-python)
-[![Powered by NumPy](https://img.shields.io/badge/powered_by-NumPy-013243?logo=numpy&logoColor=white)](https://numpy.org)
+### Ecosystem & Dependencies
+[![A Python Robotics Package](https://raw.githubusercontent.com/petercorke/robotics-toolbox-python/master/.github/svg/py_collection.min.svg)](https://github.com/petercorke/robotics-toolbox-python)
+[![QUT Centre for Robotics Open Source](https://github.com/qcr/qcr.github.io/raw/master/misc/badge.svg)](https://qcr.github.io)
+
+[![powered by NumPy](https://img.shields.io/badge/powered_by-NumPy-013243?logo=numpy&logoColor=white)](https://numpy.org)
+[![powered by SciPy](https://img.shields.io/badge/powered_by-SciPy-0054a6?logo=scipy&logoColor=white)](https://scipy.org)
+[![powered by Matplotlib](https://img.shields.io/badge/powered_by-Matplotlib-11557c?logo=matplotlib&logoColor=white)](https://matplotlib.org)
 [![Powered by OpenCV](https://raw.githubusercontent.com/petercorke/machinevision-toolbox-python/main/.github/svg/opencv_powered.svg)](https://opencv.org)
 [![Powered by Open3D](https://raw.githubusercontent.com/petercorke/machinevision-toolbox-python/main/.github/svg/open3d_powered.svg)](https://open3d.org)
+[![Powered by Spatial Maths](https://raw.githubusercontent.com/petercorke/spatialmath-python/master/.github/svg/sm_powered.min.svg)](https://github.com/petercorke/spatialmath-python)
 
 ## Synopsis
 

{machinevision_toolbox_python-2.2.0 → machinevision_toolbox_python-2.3.0}/README.md

@@ -21,20 +21,24 @@
 
 ---
 
-### Status & Ecosystem
-[![A Python Robotics Package](https://raw.githubusercontent.com/petercorke/robotics-toolbox-python/master/.github/svg/py_collection.min.svg)](https://github.com/petercorke/robotics-toolbox-python)
-[![QUT Centre for Robotics Open Source](https://github.com/qcr/qcr.github.io/raw/master/misc/badge.svg)](https://qcr.github.io)
+### Status & Project Health
+
 [![Build Status](https://github.com/petercorke/machinevision-toolbox-python/actions/workflows/ci.yml/badge.svg)](https://github.com/petercorke/machinevision-toolbox-python/actions/workflows/ci.yml)
-[![Coverage](https://codecov.io/gh/petercorke/machinevision-toolbox-python/branch/main/graph/badge.svg)](https://codecov.io/gh/petercorke/machinevision-toolbox-python)
+[![Downloads](https://static.pepy.tech/badge/machinevision-toolbox-python/month)](https://pepy.tech/projects/machinevision-toolbox-python)
 ![Python Version](https://img.shields.io/pypi/pyversions/machinevision-toolbox-python.svg)
+[![Coverage](https://codecov.io/gh/petercorke/machinevision-toolbox-python/branch/main/graph/badge.svg)](https://codecov.io/gh/petercorke/machinevision-toolbox-python)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![PyPI - Downloads](https://img.shields.io/pypi/dw/machinevision-toolbox-python)](https://pypistats.org/packages/machinevision-toolbox-python)
 
-### Powered by
-[![Powered by Spatial Maths](https://raw.githubusercontent.com/petercorke/spatialmath-python/master/.github/svg/sm_powered.min.svg)](https://github.com/petercorke/spatialmath-python)
-[![Powered by NumPy](https://img.shields.io/badge/powered_by-NumPy-013243?logo=numpy&logoColor=white)](https://numpy.org)
+### Ecosystem & Dependencies
+[![A Python Robotics Package](https://raw.githubusercontent.com/petercorke/robotics-toolbox-python/master/.github/svg/py_collection.min.svg)](https://github.com/petercorke/robotics-toolbox-python)
+[![QUT Centre for Robotics Open Source](https://github.com/qcr/qcr.github.io/raw/master/misc/badge.svg)](https://qcr.github.io)
+
+[![powered by NumPy](https://img.shields.io/badge/powered_by-NumPy-013243?logo=numpy&logoColor=white)](https://numpy.org)
+[![powered by SciPy](https://img.shields.io/badge/powered_by-SciPy-0054a6?logo=scipy&logoColor=white)](https://scipy.org)
+[![powered by Matplotlib](https://img.shields.io/badge/powered_by-Matplotlib-11557c?logo=matplotlib&logoColor=white)](https://matplotlib.org)
 [![Powered by OpenCV](https://raw.githubusercontent.com/petercorke/machinevision-toolbox-python/main/.github/svg/opencv_powered.svg)](https://opencv.org)
 [![Powered by Open3D](https://raw.githubusercontent.com/petercorke/machinevision-toolbox-python/main/.github/svg/open3d_powered.svg)](https://open3d.org)
+[![Powered by Spatial Maths](https://raw.githubusercontent.com/petercorke/spatialmath-python/master/.github/svg/sm_powered.min.svg)](https://github.com/petercorke/spatialmath-python)
 
 ## Synopsis
 

{machinevision_toolbox_python-2.2.0 → machinevision_toolbox_python-2.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "machinevision-toolbox-python"
-version = "2.2.0"
+version = "2.3.0"
 authors = [{ name = "Peter Corke", email = "rvc@petercorke.com" }]
 description = "Object-oriented machine vision for Python."
 readme = "README.md"

machinevision_toolbox_python-2.2.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-    ".": "2.2.0"
-}