Merge pull request #12 from GiorgioMedico/fix/numpy1-compat-and-relaxed-deps

NumPy 1 compatibility, relaxed deps, and uv tooling migration

Author: GiorgioMedico

.github/workflows/docs.yml

@@ -35,20 +35,17 @@ jobs:
       with:
         fetch-depth: 0
 
-    - name: Set up Python
-      uses: actions/setup-python@v5
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
       with:
-        python-version: '3.12'
-        cache: 'pip'
-    
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -e '.[docs]'
-    
+        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'

.github/workflows/pre-commit.yml

@@ -10,8 +10,19 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python
-      uses: actions/setup-python@v5
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
       with:
-        python-version: '3.12'
-    - uses: pre-commit/action@v3.0.1
+        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

.github/workflows/publish.yml

@@ -15,18 +15,14 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: 0
-    - name: Set up Python
-      uses: actions/setup-python@v5
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
       with:
-        python-version: '3.12'
-        cache: 'pip'
-    - name: Install build tools
-      run: |
-        python -m pip install --upgrade pip
-        pip install build twine
+        enable-cache: true
+        cache-dependency-glob: uv.lock
     - name: Build package
-      run: python -m build
+      run: uv build
     - name: Verify package
-      run: twine check dist/*
+      run: uvx twine check dist/*
     - name: Publish to PyPI
       uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/test.yml

@@ -1,4 +1,3 @@
-
 name: ci-test
 
 on:
@@ -14,27 +13,24 @@ jobs:
       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:
-          fetch-depth: 0
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: 'pip'
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e '.[test]'
+          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: |
-          python -m pytest tests --cov=interpolatepy --cov-report=xml --cov-report=term-missing
+        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 }}
-          file: ./coverage.xml
+          files: ./coverage.xml
           flags: unittests
           name: codecov-umbrella
           fail_ci_if_error: false

.gitignore

@@ -99,9 +99,6 @@ target/
 # Jupyter Notebook
 .ipynb_checkpoints
 
-# pyenv
-.python-version
-
 # celery beat schedule file
 celerybeat-schedule
 

.python-version

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

README.md

@@ -28,11 +28,15 @@ pip install InterpolatePy
 <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
@@ -253,22 +257,22 @@ Set `INTERPOLATEPY_NO_CPP=1` to force pure-Python mode.
 ```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
-pre-commit run --all-files
+uv run pre-commit run --all-files
 ```
 </details>
 
@@ -279,9 +283,9 @@ pre-commit run --all-files
 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.

docs/contributing.md

@@ -22,26 +22,22 @@ Thank you for your interest in contributing to InterpolatePy! This guide will he
    cd InterpolatePy
    ```
 
-2. **Create a virtual environment**:
-   ```bash
-   python -m venv venv
-   source venv/bin/activate  # On Windows: venv\Scripts\activate
-   ```
+2. **Install [uv](https://docs.astral.sh/uv/)** (project uses uv for environment management).
 
 3. **Install development dependencies**:
    ```bash
-   pip install -e '.[all]'  # Installs package + dev dependencies
+   uv sync  # creates .venv with the default dev + test groups
    ```
 
 4. **Install pre-commit hooks**:
    ```bash
-   pre-commit install
+   uv run pre-commit install
    ```
 
 5. **Verify installation**:
    ```bash
-   python -c "import interpolatepy; print(interpolatepy.__version__)"
-   pytest tests/ -v
+   uv run python -c "import interpolatepy; print(interpolatepy.__version__)"
+   uv run pytest tests/ -v
    ```
 
 ### Project Structure
@@ -104,32 +100,32 @@ Follow our [coding standards](#coding-standards) and ensure your changes:
 
 ```bash
 # Run all tests
-pytest tests/
+uv run pytest tests/
 
 # Run specific test file
-pytest tests/test_cubic_spline.py -v
+uv run pytest tests/test_cubic_spline.py -v
 
 # Run with coverage
-pytest tests/ --cov=interpolatepy --cov-report=html --cov-report=term
+uv run pytest tests/ --cov=interpolatepy --cov-report=html --cov-report=term
 
 # Run benchmarks
-pytest tests/ -k "benchmark" --benchmark-only
+uv run pytest tests/ -k "benchmark" --benchmark-only
 ```
 
 ### 4. Check Code Quality
 
 ```bash
 # Format code
-ruff format interpolatepy/
+uv run ruff format interpolatepy/
 
 # Check linting
-ruff check interpolatepy/
+uv run ruff check interpolatepy/
 
 # Type checking
-mypy interpolatepy/
+uv run mypy interpolatepy/
 
 # Run pre-commit checks
-pre-commit run --all-files
+uv run pre-commit run --all-files
 ```
 
 ### 5. Commit Changes

docs/installation.md

@@ -66,39 +66,44 @@ For contributing to InterpolatePy or accessing the latest features:
 
 ### Clone and Install
 
+InterpolatePy uses [uv](https://docs.astral.sh/uv/) for development. Install uv first, then:
+
 ```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
 ```
 
-### With Development Dependencies
+### Selecting Dependency Groups
 
 ```bash
-# Install with all optional dependencies
-pip install -e '.[all]'
+# Default: dev + test groups
+uv sync
+
+# Include the docs group as well
+uv sync --all-groups
 
-# Or install specific groups
-pip install -e '.[test]'     # Testing tools
-pip install -e '.[dev]'      # Development tools
+# Or pick a specific group
+uv sync --group test
+uv sync --group docs
 ```
 
 ### Development Tools Setup
 
 ```bash
 # Install pre-commit hooks
-pre-commit install
+uv run pre-commit install
 
 # Run code quality checks
-ruff format interpolatepy/
-ruff check interpolatepy/
-mypy interpolatepy/
+uv run ruff format interpolatepy/
+uv run ruff check interpolatepy/
+uv run mypy interpolatepy/
 
 # 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
 ```
 
 ## C++ Backend (Optional)

docs/troubleshooting.md

@@ -18,8 +18,8 @@ ModuleNotFoundError: No module named 'interpolatepy'
 # Install from PyPI
 pip install interpolatepy
 
-# Or install from source for development
-pip install -e .
+# Or install from source for development (uses uv)
+uv sync
 ```
 
 #### Problem: Specific Class Import Failed