InterpolatePy 2.0.1__tar.gz → 3.0.1__tar.gz

{interpolatepy-2.0.1 → interpolatepy-3.0.1}/.github/workflows/docs.yml

@@ -32,22 +32,20 @@ jobs:
     steps:
     - name: Checkout repository
       uses: actions/checkout@v4
-    
-    - name: Set up Python
-      uses: actions/setup-python@v5
       with:
-        python-version: '3.12'
-        cache: 'pip'
-    
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements-dev.txt
-        pip install -e .
+        fetch-depth: 0
     
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+        cache-dependency-glob: uv.lock
+
+    - name: Sync dependencies
+      run: uv sync --locked --no-default-groups --group docs
+
     - name: Build documentation
-      run: |
-        mkdocs build --clean --strict
+      run: uv run mkdocs build --clean --strict
     
     - name: Setup Pages
       if: github.ref == 'refs/heads/main' && github.event_name == 'push'

interpolatepy-3.0.1/.github/workflows/pre-commit.yml

@@ -0,0 +1,28 @@
+name: pre-commit
+
+on:
+  pull_request:
+  push:
+    branches: [ main, master ]
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+        cache-dependency-glob: uv.lock
+    - name: Sync dependencies
+      run: uv sync --locked --no-default-groups --group dev
+    - name: Cache pre-commit hook environments
+      uses: actions/cache@v4
+      with:
+        path: ~/.cache/pre-commit
+        key: pre-commit-${{ runner.os }}-${{ hashFiles('.pre-commit-config.yaml') }}
+        restore-keys: |
+          pre-commit-${{ runner.os }}-
+    - name: Run pre-commit
+      run: uv run pre-commit run --all-files --show-diff-on-failure

interpolatepy-3.0.1/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    environment: pypi
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+        cache-dependency-glob: uv.lock
+    - name: Build package
+      run: uv build
+    - name: Verify package
+      run: uvx twine check dist/*
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

interpolatepy-3.0.1/.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: ci-test
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ['3.11', '3.12', '3.13']
+    env:
+      UV_PYTHON: ${{ matrix.python-version }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - name: Sync dependencies
+        run: uv sync --locked --no-default-groups --group test
+      - name: Testing with coverage
+        run: uv run pytest tests --cov=interpolatepy --cov-report=xml --cov-report=term-missing
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false

{interpolatepy-2.0.1 → interpolatepy-3.0.1}/.gitignore

@@ -99,9 +99,6 @@ target/
 # Jupyter Notebook
 .ipynb_checkpoints
 
-# pyenv
-.python-version
-
 # celery beat schedule file
 celerybeat-schedule
 
@@ -141,3 +138,13 @@ venv.bak/
 .history
 
 CLAUDE.md
+
+################################
+########### C++ BUILD ##########
+################################
+cpp/build/
+*.o
+*.a
+*.so
+*.dylib
+compile_commands.json

{interpolatepy-2.0.1 → interpolatepy-3.0.1}/.pre-commit-config.yaml

@@ -12,14 +12,14 @@ repos:
       - id: check-toml
 
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.12.8'
+    rev: 'v0.15.7'
     hooks:
     -   id: ruff
         types_or: [python, pyi, jupyter]
         args: [ --fix, --exit-non-zero-on-fix, --preview ]
 
 -   repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.17.1
+    rev: v1.19.1
     hooks:
     -   id: mypy
         args: [--ignore-missing-imports]

interpolatepy-3.0.1/.python-version

@@ -0,0 +1 @@
+3.12

{interpolatepy-2.0.1 → interpolatepy-3.0.1}/InterpolatePy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: InterpolatePy
-Version: 2.0.1
+Version: 3.0.1
 Summary: A comprehensive Python library for generating smooth trajectories and curves with precise control over position, velocity, acceleration, and jerk profiles
 Author-email: Giorgio Medico <giorgio.medico11@gmail.com>
 Maintainer-email: Giorgio Medico <giorgio.medico11@gmail.com>
@@ -17,7 +17,6 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -31,32 +30,18 @@ Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: C++
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: numpy>=2.3.0
-Requires-Dist: matplotlib>=3.10.5
-Requires-Dist: scipy>=1.16.0
-Provides-Extra: test
-Requires-Dist: pytest>=8.4.0; extra == "test"
-Requires-Dist: pytest-cov>=4.1.0; extra == "test"
-Requires-Dist: codecov>=2.1.13; extra == "test"
-Requires-Dist: pytest-benchmark>=4.0.0; extra == "test"
-Requires-Dist: pre-commit>=4.2.0; extra == "test"
-Provides-Extra: dev
-Requires-Dist: ruff>=0.12.8; extra == "dev"
-Requires-Dist: mypy>=1.17.0; extra == "dev"
-Requires-Dist: pre-commit>=4.2.0; extra == "dev"
-Requires-Dist: pyright>=1.1.400; extra == "dev"
-Requires-Dist: build>=1.0.3; extra == "dev"
-Requires-Dist: twine>=4.0.2; extra == "dev"
-Provides-Extra: all
-Requires-Dist: interpolatepy[dev,test]; extra == "all"
+Requires-Dist: numpy>=1.26
+Requires-Dist: matplotlib>=3.6
+Requires-Dist: scipy>=1.11
 Dynamic: license-file
 
 # InterpolatePy
 
-![Python](https://img.shields.io/badge/python-3.10+-blue)
+![Python](https://img.shields.io/badge/python-3.11+-blue)
 [![PyPI Downloads](https://static.pepy.tech/badge/interpolatepy)](https://pepy.tech/projects/interpolatepy)
 [![pre-commit](https://github.com/GiorgioMedico/InterpolatePy/actions/workflows/pre-commit.yml/badge.svg)](https://github.com/GiorgioMedico/InterpolatePy/actions/workflows/pre-commit.yml)
 [![ci-test](https://github.com/GiorgioMedico/InterpolatePy/actions/workflows/test.yml/badge.svg)](https://github.com/GiorgioMedico/InterpolatePy/actions/workflows/test.yml)
@@ -66,9 +51,9 @@ Dynamic: license-file
 
 InterpolatePy provides 20+ algorithms for smooth trajectory generation with precise control over position, velocity, acceleration, and jerk. From cubic splines and B-curves to quaternion interpolation and S-curve motion profiles — everything you need for professional motion control.
 
-**⚡ Fast:** Vectorized NumPy operations, ~1ms for 1000-point cubic splines  
-**🎯 Precise:** Research-grade algorithms with C² continuity and bounded derivatives  
-**📊 Visual:** Built-in plotting for every algorithm  
+**⚡ Fast:** Optional C++ backend with pybind11; pure-Python fallback uses vectorized NumPy
+**🎯 Precise:** Research-grade algorithms with C² continuity and bounded derivatives
+**📊 Visual:** Built-in plotting for every algorithm
 **🔧 Complete:** Splines, motion profiles, quaternions, and path planning in one library
 
 ---
@@ -79,16 +64,20 @@ InterpolatePy provides 20+ algorithms for smooth trajectory generation with prec
 pip install InterpolatePy
 ```
 
-**Requirements:** Python ≥3.10, NumPy ≥2.0, SciPy ≥1.15, Matplotlib ≥3.10
+**Requirements:** Python ≥3.11, NumPy ≥2.3, SciPy ≥1.16, Matplotlib ≥3.10.5
 
 <details>
 <summary><strong>Development Installation</strong></summary>
 
+This project uses [uv](https://docs.astral.sh/uv/) for dependency and environment management.
+
 ```bash
 git clone https://github.com/GiorgioMedico/InterpolatePy.git
 cd InterpolatePy
-pip install -e '.[all]'  # Includes testing and development tools
+uv sync  # creates .venv with the default dev + test groups
 ```
+
+To include the docs group as well: `uv sync --all-groups`.
 </details>
 
 ## Quick Start
@@ -278,12 +267,23 @@ plt.show()
 
 ## Performance & Quality
 
-- **Fast:** Vectorized NumPy operations, optimized algorithms
-- **Reliable:** 85%+ test coverage, continuous integration
-- **Modern:** Python 3.10+, strict typing, dataclass-based APIs
+- **Fast:** Optional C++ backend (Eigen + pybind11) for maximum performance; pure-Python fallback uses vectorized NumPy
+- **Reliable:** 85%+ test coverage, continuous integration, 142 additional C++ unit tests
+- **Modern:** Python 3.11+, strict typing, dataclass-based APIs
 - **Research-grade:** Peer-reviewed algorithms from robotics literature
 
-**Typical Performance:**
+**C++ Backend:**
+
+InterpolatePy includes an optional compiled C++ extension for performance-critical workloads. The API is identical regardless of backend:
+
+```python
+import interpolatepy
+print(f"C++ backend: {interpolatepy.HAS_CPP}")  # True if extension is available
+```
+
+Set `INTERPOLATEPY_NO_CPP=1` to force pure-Python mode.
+
+**Typical Performance (pure-Python):**
 - Cubic spline (1000 points): ~1ms
 - B-spline evaluation (10k points): ~5ms
 - S-curve trajectory planning: ~0.5ms
@@ -298,20 +298,22 @@ plt.show()
 ```bash
 git clone https://github.com/GiorgioMedico/InterpolatePy.git
 cd InterpolatePy
-pip install -e '.[all]'
-pre-commit install
+uv sync                       # creates .venv with dev + test groups
+uv run pre-commit install
 
 # Run tests
-python -m pytest tests/
+uv run pytest tests/
 
 # Run tests with coverage
-python -m pytest tests/ --cov=interpolatepy --cov-report=html --cov-report=term
+uv run pytest tests/ --cov=interpolatepy --cov-report=html --cov-report=term
 
 # Code quality
-ruff format interpolatepy/
-ruff check interpolatepy/
-mypy interpolatepy/
+uv run ruff format interpolatepy/
+uv run ruff check interpolatepy/
+uv run mypy interpolatepy/
 
+# Run all pre-commit hooks
+uv run pre-commit run --all-files
 ```
 </details>
 
@@ -322,9 +324,9 @@ mypy interpolatepy/
 Contributions welcome! Please:
 
 1. Fork the repo and create a feature branch
-2. Install dev dependencies: `pip install -e '.[all]'`
+2. Install dev dependencies: `uv sync`
 3. Follow existing patterns and add tests
-4. Run `pre-commit run --all-files` before submitting
+4. Run `uv run pre-commit run --all-files` before submitting
 5. Open a pull request with clear description
 
 For major changes, open an issue first to discuss the approach.

interpolatepy-3.0.1/InterpolatePy.egg-info/SOURCES.txt

@@ -0,0 +1,215 @@
+.editorconfig
+.gitattributes
+.gitignore
+.pre-commit-config.yaml
+.python-version
+ALGORITHMS.md
+LICENSE
+README.md
+codecov.yml
+mkdocs.yml
+pyproject.toml
+uv.lock
+.github/FUNDING.yml
+.github/workflows/docs.yml
+.github/workflows/pre-commit.yml
+.github/workflows/publish.yml
+.github/workflows/test.yml
+InterpolatePy.egg-info/PKG-INFO
+InterpolatePy.egg-info/SOURCES.txt
+InterpolatePy.egg-info/dependency_links.txt
+InterpolatePy.egg-info/requires.txt
+InterpolatePy.egg-info/top_level.txt
+cpp/CMakeLists.txt
+cpp/bindings/CMakeLists.txt
+cpp/bindings/bind_acc_splines.cpp
+cpp/bindings/bind_bspline.cpp
+cpp/bindings/bind_cubic_spline.cpp
+cpp/bindings/bind_motion.cpp
+cpp/bindings/bind_paths.cpp
+cpp/bindings/bind_quaternion.cpp
+cpp/bindings/bind_smoothing_search.cpp
+cpp/bindings/bind_smoothing_spline.cpp
+cpp/bindings/bind_tridiagonal.cpp
+cpp/bindings/module.cpp
+cpp/cmake/InterpolateCppConfig.cmake.in
+cpp/cmake/version.hpp.in
+cpp/examples/CMakeLists.txt
+cpp/examples/bspline_approx_smooth_example.cpp
+cpp/examples/bspline_cubic_example.cpp
+cpp/examples/bspline_example.cpp
+cpp/examples/bspline_interpolator_example.cpp
+cpp/examples/concepts_example.cpp
+cpp/examples/cubic_smoothing_example.cpp
+cpp/examples/cubic_spline_acc1_example.cpp
+cpp/examples/cubic_spline_acc2_example.cpp
+cpp/examples/cubic_spline_example.cpp
+cpp/examples/double_s_example.cpp
+cpp/examples/parabolic_linear_example.cpp
+cpp/examples/paths_example.cpp
+cpp/examples/polynomial_example.cpp
+cpp/examples/quaternion_example.cpp
+cpp/examples/trapezoidal_example.cpp
+cpp/examples/shared/example_utils.hpp
+cpp/include/interpolatecpp/concepts.hpp
+cpp/include/interpolatecpp/config.hpp
+cpp/include/interpolatecpp/tridiagonal.hpp
+cpp/include/interpolatecpp/bspline/approximation_bspline.hpp
+cpp/include/interpolatecpp/bspline/bspline.hpp
+cpp/include/interpolatecpp/bspline/bspline_interpolator.hpp
+cpp/include/interpolatecpp/bspline/bspline_parameters.hpp
+cpp/include/interpolatecpp/bspline/cubic_bspline_interpolation.hpp
+cpp/include/interpolatecpp/bspline/smoothing_cubic_bspline.hpp
+cpp/include/interpolatecpp/motion/double_s_trajectory.hpp
+cpp/include/interpolatecpp/motion/motion_types.hpp
+cpp/include/interpolatecpp/motion/parabolic_blend_trajectory.hpp
+cpp/include/interpolatecpp/motion/polynomial_trajectory.hpp
+cpp/include/interpolatecpp/motion/trapezoidal_trajectory.hpp
+cpp/include/interpolatecpp/path/circular_path.hpp
+cpp/include/interpolatecpp/path/frenet_frame.hpp
+cpp/include/interpolatecpp/path/linear_path.hpp
+cpp/include/interpolatecpp/path/linear_traj.hpp
+cpp/include/interpolatecpp/quat/log_quaternion_interpolation.hpp
+cpp/include/interpolatecpp/quat/modified_log_quaternion_interpolation.hpp
+cpp/include/interpolatecpp/quat/quaternion.hpp
+cpp/include/interpolatecpp/quat/quaternion_spline.hpp
+cpp/include/interpolatecpp/quat/squad_c2.hpp
+cpp/include/interpolatecpp/spline/cubic_smoothing_spline.hpp
+cpp/include/interpolatecpp/spline/cubic_spline.hpp
+cpp/include/interpolatecpp/spline/cubic_spline_with_acc1.hpp
+cpp/include/interpolatecpp/spline/cubic_spline_with_acc2.hpp
+cpp/include/interpolatecpp/spline/smoothing_search.hpp
+cpp/include/interpolatecpp/spline/spline_parameters.hpp
+cpp/src/approximation_bspline.cpp
+cpp/src/bspline.cpp
+cpp/src/bspline_interpolator.cpp
+cpp/src/circular_path.cpp
+cpp/src/cubic_bspline_interpolation.cpp
+cpp/src/cubic_smoothing_spline.cpp
+cpp/src/cubic_spline.cpp
+cpp/src/cubic_spline_with_acc1.cpp
+cpp/src/cubic_spline_with_acc2.cpp
+cpp/src/double_s_trajectory.cpp
+cpp/src/frenet_frame.cpp
+cpp/src/linear_path.cpp
+cpp/src/linear_traj.cpp
+cpp/src/log_quaternion_interpolation.cpp
+cpp/src/modified_log_quaternion_interpolation.cpp
+cpp/src/parabolic_blend_trajectory.cpp
+cpp/src/polynomial_trajectory.cpp
+cpp/src/quaternion.cpp
+cpp/src/quaternion_spline.cpp
+cpp/src/smoothing_cubic_bspline.cpp
+cpp/src/smoothing_search.cpp
+cpp/src/squad_c2.cpp
+cpp/src/trapezoidal_trajectory.cpp
+cpp/tests/CMakeLists.txt
+cpp/tests/test_bspline.cpp
+cpp/tests/test_bspline_variants.cpp
+cpp/tests/test_concepts.cpp
+cpp/tests/test_cubic_smoothing_spline.cpp
+cpp/tests/test_cubic_spline.cpp
+cpp/tests/test_cubic_spline_with_acc1.cpp
+cpp/tests/test_cubic_spline_with_acc2.cpp
+cpp/tests/test_double_s_trajectory.cpp
+cpp/tests/test_parabolic_blend_trajectory.cpp
+cpp/tests/test_paths.cpp
+cpp/tests/test_polynomial_trajectory.cpp
+cpp/tests/test_quaternion.cpp
+cpp/tests/test_quaternion_spline.cpp
+cpp/tests/test_smoothing_search.cpp
+cpp/tests/test_trapezoidal_trajectory.cpp
+cpp/tests/test_tridiagonal.cpp
+cpp/tests/shared/test_data.hpp
+docs/algorithms.md
+docs/api-reference.md
+docs/architecture.md
+docs/changelog.md
+docs/contributing.md
+docs/examples.md
+docs/index.md
+docs/installation.md
+docs/quickstart.md
+docs/troubleshooting.md
+docs/user-guide.md
+docs/assets/extra.css
+docs/assets/extra.js
+docs/tutorials/motion-profiles.md
+docs/tutorials/path-planning.md
+docs/tutorials/quaternion-interpolation.md
+docs/tutorials/spline-interpolation.md
+examples/b_spline_approx_ex.py
+examples/b_spline_cubic_ex.py
+examples/b_spline_ex.py
+examples/b_spline_interpolate_ex.py
+examples/b_spline_smooth_ex.py
+examples/c_s_smoot_search_ex.py
+examples/c_s_smoothing_ex.py
+examples/c_s_with_acc1_ex.py
+examples/c_s_with_acc2_ex.py
+examples/cubic_spline_ex.py
+examples/double_s_ex.py
+examples/frenet_frame_ex.py
+examples/lin_poly_parabolic_ex.py
+examples/linear_ex.py
+examples/log_quat_ex.py
+examples/log_quat_new_ex.py
+examples/main.py
+examples/polynomials_ex.py
+examples/protocols_ex.py
+examples/quat_visualization_ex.py
+examples/simple_paths_ex.py
+examples/squad_c2_ex.py
+examples/trapezoidal_ex.py
+interpolatepy/__init__.py
+interpolatepy/_api.py
+interpolatepy/_backend.py
+interpolatepy/b_spline.py
+interpolatepy/b_spline_approx.py
+interpolatepy/b_spline_cubic.py
+interpolatepy/b_spline_interpolate.py
+interpolatepy/b_spline_smooth.py
+interpolatepy/c_s_smoot_search.py
+interpolatepy/c_s_smoothing.py
+interpolatepy/c_s_with_acc1.py
+interpolatepy/c_s_with_acc2.py
+interpolatepy/cubic_spline.py
+interpolatepy/double_s.py
+interpolatepy/frenet_frame.py
+interpolatepy/lin_poly_parabolic.py
+interpolatepy/linear.py
+interpolatepy/log_quat.py
+interpolatepy/polynomials.py
+interpolatepy/protocols.py
+interpolatepy/quat_core.py
+interpolatepy/quat_spline.py
+interpolatepy/quat_visualization.py
+interpolatepy/simple_paths.py
+interpolatepy/squad_c2.py
+interpolatepy/trapezoidal.py
+interpolatepy/tridiagonal_inv.py
+interpolatepy/version.py
+interpolatepy/_adapters/__init__.py
+interpolatepy/_adapters/_bspline.py
+interpolatepy/_adapters/_direct.py
+interpolatepy/_adapters/_motion.py
+interpolatepy/_adapters/_paths.py
+interpolatepy/_adapters/_quaternion.py
+interpolatepy/_adapters/_spline.py
+tests/__init__.py
+tests/inv_test.py
+tests/test_b_spline.py
+tests/test_b_spline_variants.py
+tests/test_backend.py
+tests/test_cubic_spline.py
+tests/test_lin_poly_parabolic.py
+tests/test_linear.py
+tests/test_log_quat.py
+tests/test_motion_profiles.py
+tests/test_path_planning.py
+tests/test_polynomials.py
+tests/test_protocols.py
+tests/test_quat_interp.py
+tests/test_quat_visualization.py
+tests/test_smoothing.py
+tests/test_squad_c2.py

interpolatepy-3.0.1/InterpolatePy.egg-info/requires.txt

@@ -0,0 +1,3 @@
+numpy>=1.26
+matplotlib>=3.6
+scipy>=1.11