chore: <3.9 dropped

Author: Gunther Klessinger

MIGRATION.md

@@ -0,0 +1,101 @@
+# Migration from make/poetry to just/uv
+
+## Quick Start
+
+1. **Install just and uv** (if not already installed):
+   ```bash
+   brew install just uv
+   ```
+
+2. **Initialize the environment**:
+   ```bash
+   just init
+   ```
+
+3. **Common commands**:
+   ```bash
+   just test           # Run tests
+   just docs           # Build documentation  
+   just docs-serve     # Serve docs locally
+   just format         # Format code
+   just build          # Build package
+   just clean          # Clean build artifacts
+   ```
+
+## Command Mapping
+
+| Old (make) | New (just) | Description |
+|------------|------------|-------------|
+| `source ./make -a && make tests` | `just test` | Run tests |
+| `make docs` | `just docs` | Build documentation |
+| `make docs-serve` | `just docs-serve` | Serve documentation |
+| `make clean` | `just clean` | Clean build artifacts |
+| `make release <version>` | `just release <version>` | Release new version |
+
+## Key Changes
+
+### Dependencies Management
+- **Before**: Poetry managed dependencies
+- **After**: uv manages dependencies (much faster)
+- **Migration**: Dependencies moved from `[tool.poetry.dependencies]` to `[project.dependencies]` in pyproject.toml
+
+### Build System  
+- **Before**: Poetry build backend
+- **After**: Hatchling build backend (modern, standards-compliant)
+
+### System Dependencies
+- **Before**: Installed via conda through `environ` file
+- **After**: Installed via `brew install` in `just init`
+- **Dependencies**: tmux, poetry, graphviz, imagemagick
+
+### Task Runner
+- **Before**: Bash functions in `make` script
+- **After**: Just recipes in `justfile`
+- **Benefits**:
+  - Better syntax highlighting
+  - Built-in help system (`just --list`)
+  - Cross-platform compatibility
+  - More readable recipe syntax
+
+## Environment Setup
+
+The old `environ` file approach is replaced by:
+
+1. System dependencies via `just init` (uses brew)
+2. Python dependencies via `uv sync`
+3. Environment variables can be set in `.env` files (uv loads them automatically)
+
+## Development Workflow
+
+```bash
+# One-time setup
+just init
+
+# Daily development
+just test              # Run tests
+just format           # Format code before committing
+just docs-serve       # Preview documentation
+
+# Release workflow  
+just test             # Ensure tests pass
+just build            # Build package
+just release 2024.01.15  # Release with version
+```
+
+## Migration Status
+
+✅ **Completed**:
+- Basic task runner (just)
+- Dependency management (uv)
+- Build system (hatchling)
+- Common development tasks
+- System dependency installation
+
+⏳ **Not Yet Migrated**:
+- All advanced make functions (conda environment management, etc.)
+- Git hooks and automation
+- Advanced CI/CD integrations
+- Coverage combination logic
+- Changelog generation
+
+These can be added incrementally as needed.

justfile

@@ -0,0 +1,115 @@
+# docutools - Development Task Runner
+# Modern replacement for the make script using just
+
+# Default recipe to display help
+default:
+    @just --list
+
+# Initialize development environment using brew. Tested on OSX
+init:
+    @command -v brew >/dev/null || (echo "❌ Error: Homebrew is required but not installed." && echo "Install it from: https://brew.sh" && exit 1)
+    @echo "Installing system dependencies..."
+    brew install tmux graphviz imagemagick
+    @echo "Setting up uv and installing dependencies..."
+    uv sync
+    @echo "Development environment ready!"
+
+# Install/sync dependencies
+install:
+    uv sync
+
+# Run all tests
+test *ARGS:
+    uv run pytest {{ARGS}} tests -c config/pytest.ini
+
+# Run tests with coverage
+test-cov:
+    uv run coverage run --rcfile=config/coverage.pytest.ini -m pytest tests -c config/pytest.ini
+    uv run coverage combine
+    uv run coverage report --precision=2
+
+# Format code with black
+format:
+    uv run black src tests
+    uv run isort src tests
+
+# Run type checking
+typecheck:
+    uv run mypy src
+
+# Lint code
+lint:
+    uv run flake8 src tests
+
+# Run all quality checks (format, lint, typecheck)
+check: format lint typecheck
+
+# Build documentation
+docs:
+    rm -f docs/autodocs
+    uv run coverage run --rcfile=config/coverage.lp.ini $(uv run which mkdocs) build
+
+# Serve documentation locally
+docs-serve PORT="2222":
+    @echo "Serving docs on http://127.0.0.1:{{PORT}}"
+    @pkill -f "mkdocs serve.*{{PORT}}" || true
+    uv run mkdocs serve -a "127.0.0.1:{{PORT}}"
+
+# Check documentation links
+docs-checklinks:
+    @command -v linkchecker >/dev/null || (echo "Install linkchecker: pip install git+https://github.com/linkchecker/linkchecker.git" && exit 1)
+    linkchecker site --ignore-url '(.*).json'
+
+# Clean build artifacts and caches
+clean:
+    rm -f .coverage*
+    rm -rf .mypy_cache .pytest_cache build dist pip-wheel-metadata site public __pycache__
+    find . -name "*.pyc" -delete
+    find . -name "__pycache__" -type d -exec rm -rf {} + 2>/dev/null || true
+
+# Clean LP (Literal Programming) caches
+clean-lp:
+    @echo "Cleaning LP caches..."
+    find . -name "*.lp.py" -delete
+
+# Build the package
+build:
+    uv build
+
+# Release a new version
+release VERSION="": 
+    #!/usr/bin/env bash
+    set -euo pipefail
+    
+    VERSION_ARG="{{VERSION}}"
+    if [ -z "$VERSION_ARG" ]; then
+        # Use calendar versioning by default
+        VERSION_ARG=$(date "+%Y.%m.%d")
+        echo "Using calendar version: $VERSION_ARG"
+    fi
+    
+    echo "Releasing version $VERSION_ARG"
+    
+    # Update version in pyproject.toml
+    sed -i '' "s/^version = .*/version = \"$VERSION_ARG\"/" pyproject.toml
+    
+    # Run tests
+    just test
+    
+    # Build docs
+    just docs
+    
+    # Build package  
+    just build
+    
+    # Commit and tag
+    git commit -am "chore: Prepare release $VERSION_ARG" || true
+    git tag "$VERSION_ARG"
+    
+    echo "Release $VERSION_ARG ready. Run 'git push --tags' and publish manually."
+
+# Development shortcuts
+alias t := test
+alias d := docs  
+alias ds := docs-serve
+alias clc := clean-lp