pyscotch 7.0.0__tar.gz

pyscotch-7.0.0/CHANGELOG.md

@@ -0,0 +1,111 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [7.0.0] - 2026-07-13
+
+### Changed - Versioning scheme
+- Versions now mirror the supported Scotch series: `X.Y` = Scotch major.minor
+  (7.0.x), the patch digit is PyScotch's own release counter. Hence the jump
+  from 0.2.0 to 7.0.0.
+
+### Added - Interop
+- `Graph.from_scipy_sparse()` / `Graph.to_scipy_sparse()` — exact CSR round-trips, strict symmetry/self-loop/weight validation
+- `Graph.from_networkx()` / `Graph.to_networkx()` — arbitrary node labels via `(graph, nodes)` mapping
+- `interop` optional dependency extra (`pip install "pyscotch[interop]"`)
+
+### Added - Packaging & Distribution
+- Binary wheel pipeline: `.github/workflows/wheels.yml` (cibuildwheel, manylinux_2_28, x86_64 + aarch64), `scripts/build_wheel_libs.sh`, `MANIFEST.in`; wheels bundle sequential Scotch (32- and 64-bit) and are tagged `py3-none-<platform>`
+- System-Scotch support: automatic fallback to distro/conda `libscotch` (dlopen by soname), `PYSCOTCH_SYSTEM=1` to force it, `PYSCOTCH_LIB_DIR` explicit override
+- Unsuffixed-symbol support with integer-width verification via `SCOTCH_numSizeof()` — unblocks conda-forge (`packaging/conda/meta.yaml` recipe skeleton)
+- `c_fopen` falls back to the platform libc when no compat shim is present (system-Scotch mode)
+
+### Added - Verification & Testing
+- `tests/pyscotch_base/test_binding_signatures.py` — every ctypes binding diff-checked against the parsed Scotch headers (existence, arg counts, arg types, return types)
+- 26 behavioral tests upgrading coverage: save/load roundtrips parsed back, hand-checked `graphStat`/mesh duals, context determinism, all 10 architecture topologies, `dgraphCoarsenVertLocMax` under mpirun
+- 42 interop tests (round-trips, validation errors, karate-club end-to-end partition)
+
+### Added - Documentation
+- Auto-generated API reference (`docs/site/gen_api.py`) from the `@scotch_binding` decorator registries, with coverage stats
+- SVG diagrams replacing ASCII art (triangle graph, multilevel V-cycle, architecture layers); flat single-surface site theme; GitHub Primer syntax highlighting
+- `docs/FINDINGS.md` — index of all internal and upstream findings
+
+### Changed
+- **Default variant is now 64-bit sequential** (`PYSCOTCH_INT_SIZE=64`, `PYSCOTCH_PARALLEL=0`; was 32/0 in code, documented as 64/1). 64-bit indices are safe at any graph size, and a sequential default is required for the binary wheels, which do not ship PT-Scotch. conda-forge's `scotch` is 64-bit, so it matches the new default; a mismatched-width system Scotch gets a load-time error naming the correct `PYSCOTCH_INT_SIZE`.
+
+### Fixed - Binding signatures (found by the new signature verifier)
+- `SCOTCH_meshBuild` (missing parameter), `SCOTCH_meshData` (3 missing parameters), `SCOTCH_dgraphData` (misaligned 16/17 layout)
+- `SCOTCH_version` now uses `int*` per the header (was `SCOTCH_Num*`)
+- `SCOTCH_memCur`/`SCOTCH_memMax` return `SCOTCH_Idx` (was wrong-width `c_long` on 32-bit)
+- `Dgraph.data()` MPI communicator buffer widened to `c_void_p` — was a 4-byte buffer receiving an 8-byte OpenMPI handle (memory corruption)
+- `SCOTCH_memFree` resolved despite upstream exporting it unsuffixed
+
+### Upstream (reported in docs/QUESTIONS_FOR_SCOTCH_TEAM_2.md)
+- Scotch 7.0.12 does not build with `SCOTCH_RENAME_ALL` (`SCOTCH_meshBuildElem` missing from module.h) — verified fix in `patches/scotch-7.0.12-rename-all-fix.patch`; full suite passes on patched 7.0.12
+- `SCOTCH_memFree` missing from the module.h rename table (7.0.11 and 7.0.12)
+- `SCOTCH_contextOptionSetNum` switches on the option value instead of the option index
+
+## [0.2.0] - 2025-11-18
+
+### Added - Distributed Graph Operations (Phase 1 Complete! 🎉)
+- **NEW:** `Dgraph.ghst()` - Compute ghost edge array for distributed graphs
+- **NEW:** `Dgraph.grow()` - Grow subgraphs from seed vertices (adaptive mesh refinement)
+- **NEW:** `Dgraph.band()` - Extract band graph from frontier (sparse matrix reordering)
+- **NEW:** `Dgraph.redist()` - Redistribute graph across processes (dynamic load balancing)
+- **NEW:** `Dgraph.induce_part()` - Extract induced subgraph from partition (hierarchical partitioning)
+- **100% Scotch Coverage:** All 6 Scotch distributed graph operations now implemented!
+
+### Added - Testing & Validation
+- Integration test: Sequential partitioning workflow (end-to-end)
+- Integration test: Distributed coarsening workflow (MPI)
+- Integration test: Mesh partitioning workflow
+- 4 new MPI test ports matching Scotch C tests exactly:
+  - `dgraph_grow.py` - Region growing test
+  - `dgraph_band.py` - Band graph extraction test
+  - `dgraph_redist.py` - Graph redistribution test
+  - `dgraph_induce_part.py` - Induced subgraph test
+- Total test count: 192 passing tests (was 188)
+
+### Added - Examples & Documentation
+- `examples/distributed_coarsening.py` - MPI coarsening example
+- `examples/mesh_partitioning.py` - Mesh partitioning example
+- `examples/README.md` - Comprehensive examples documentation
+- `benchmarks/benchmark_sequential_partitioning.py` - Performance benchmarking
+- `benchmarks/benchmark_distributed_operations.py` - MPI benchmarking
+- `benchmarks/README.md` - Benchmark documentation
+- Updated `ROADMAP.md` - Phase 1 complete, now 80% overall completion
+- Updated `MPI_TEST_COVERAGE.md` - 100% coverage achieved
+
+### Added - Build & Development
+- `make test` now runs `pytest -vvvv` for detailed test output
+- Makefile improvements for better developer experience
+
+### Changed
+- Project completion: 65% → 80% (Phase 1 complete)
+- MPI test coverage: 33% → 100% (6/6 operations)
+- Documentation updated to reflect new capabilities
+
+### Performance
+- All distributed operations tested and validated
+- Benchmarks available for performance comparison
+- Ready for production distributed graph processing
+
+## [0.1.0] - 2024-XX-XX
+
+### Added
+- Initial release
+- Graph partitioning support
+- Mesh partitioning support
+- Sparse matrix ordering support
+- Command-line interface
+- Python API with type hints
+- PT-Scotch library integration
+- Makefile-based build system
+
+[Unreleased]: https://github.com/c4ffein/pyscotch/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/c4ffein/pyscotch/releases/tag/v0.1.0

pyscotch-7.0.0/CONTRIBUTING.md

@@ -0,0 +1,141 @@
+# Contributing to PyScotch
+
+Thank you for your interest in contributing to PyScotch!
+
+## Development Setup
+
+1. Clone the repository:
+```bash
+git clone <repository-url>
+cd pyscotch
+```
+
+2. Add the Scotch submodule:
+```bash
+git submodule add https://gitlab.inria.fr/scotch/scotch.git external/scotch
+git submodule update --init --recursive
+```
+
+3. Build the Scotch library:
+```bash
+make build-scotch
+```
+
+4. Install development dependencies:
+```bash
+pip install -e ".[dev]"
+```
+
+## Building the Library
+
+The project uses a Makefile to build the Scotch library:
+
+```bash
+# Build sequential Scotch
+make build-scotch
+
+# Build parallel PT-Scotch
+make build-ptscotch
+
+# Build both
+make all
+
+# Clean build artifacts
+make clean-scotch
+```
+
+## Code Style
+
+- Follow PEP 8 guidelines
+- Use type hints where possible
+- Maximum line length: 100 characters
+- Use Black for formatting: `black pyscotch/`
+- Run flake8 for linting: `flake8 pyscotch/`
+
+## Testing
+
+Run tests with pytest:
+
+```bash
+# Run all tests
+pytest tests/
+
+# Run with coverage
+pytest tests/ --cov=pyscotch --cov-report=html
+
+# Run specific test file
+pytest tests/test_graph.py -v
+```
+
+Note: Tests require the Scotch library to be built first.
+
+## Documentation
+
+- Add docstrings to all public functions and classes
+- Follow Google-style docstring format
+- Update API.md when adding new features
+- Add examples for significant new features
+
+## Pull Request Process
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass
+6. Update documentation
+7. Commit with clear messages
+8. Push to your fork
+9. Open a pull request
+
+## Commit Message Guidelines
+
+- Use present tense: "Add feature" not "Added feature"
+- Use imperative mood: "Move cursor to..." not "Moves cursor to..."
+- Reference issues and pull requests when relevant
+- First line: brief summary (50 chars or less)
+- Followed by blank line and detailed description if needed
+
+## Adding New Features
+
+When adding new PT-Scotch functionality:
+
+1. Add low-level bindings in `libscotch.py`
+2. Create or update high-level Python class
+3. Add CLI command if appropriate (in `cli.py`)
+4. Write tests
+5. Update documentation
+6. Add example if helpful
+
+## Project Structure
+
+```
+pyscotch/
+├── pyscotch/           # Main package
+│   ├── __init__.py     # Package initialization
+│   ├── libscotch.py    # Low-level C bindings
+│   ├── graph.py        # Graph class
+│   ├── mesh.py         # Mesh class
+│   ├── strategy.py     # Strategy class
+│   ├── arch.py         # Architecture class
+│   ├── mapping.py      # Mapping class
+│   ├── ordering.py     # Ordering class
+│   └── cli.py          # Command-line interface
+├── tests/              # Test files
+├── examples/           # Example scripts
+├── docs/               # Documentation
+├── external/           # External dependencies
+│   └── scotch/         # Scotch submodule
+├── Makefile           # Build system
+└── setup.py           # Package configuration
+```
+
+## Questions?
+
+Feel free to open an issue for:
+- Bug reports
+- Feature requests
+- Questions about usage or development
+- Documentation improvements
+
+Thank you for contributing!

pyscotch-7.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 c4ffein
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyscotch-7.0.0/MANIFEST.in

@@ -0,0 +1,27 @@
+# sdist contents. sdist users build Scotch from source (see README), so the
+# sdist ships the build tooling (Makefile, patches, compat C source) but NEVER
+# any prebuilt binaries, the scotch submodule, or local build trees.
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include Makefile
+include pyproject.toml
+include pyscotch/py.typed
+recursive-include pyscotch/native *.c
+recursive-include patches *
+recursive-include scripts *.sh
+recursive-include tests *.py *.md
+recursive-include examples *.py
+
+# Never ship binaries or build trees in the sdist. Note: this does not affect
+# binary wheels — the pyscotch/_libs/*.so files are included in wheels via the
+# explicit package_data globs in setup.py.
+prune pyscotch/_libs
+prune scotch-builds
+prune external
+prune docs
+prune benchmarks
+prune scotchpy
+global-exclude *.so *.a *.o *.py[cod]
+global-exclude __pycache__

pyscotch-7.0.0/Makefile

@@ -0,0 +1,216 @@
+# Makefile for building PT-Scotch and PyScotch
+
+# Directories
+SCOTCH_DIR = external/scotch
+SCOTCH_SRC = $(SCOTCH_DIR)/src
+BUILDS_DIR = scotch-builds
+
+# Compiler settings
+CC = gcc
+MPICC = mpicc
+LDFLAGS = -lm -lpthread -lz
+
+# Platform detection
+UNAME_S := $(shell uname -s)
+ifeq ($(UNAME_S),Linux)
+    SHARED_EXT = so
+    SHARED_FLAGS = -shared
+endif
+ifeq ($(UNAME_S),Darwin)
+    SHARED_EXT = dylib
+    SHARED_FLAGS = -dynamiclib
+endif
+
+# Targets
+.PHONY: all build-all build-32 build-64 build-seq-only build-seq-32 build-seq-64 clean clean-scotch install test test-full test-quadrant help
+
+help:
+	@echo "PyScotch Build System"
+	@echo "====================="
+	@echo ""
+	@echo "Build targets:"
+	@echo "  make build-all    - Build all 4 variants (scotch+ptscotch × 32+64-bit)"
+	@echo "  make build-32     - Build both scotch and ptscotch with 32-bit integers"
+	@echo "  make build-64     - Build both scotch and ptscotch with 64-bit integers"
+	@echo "  make build-seq-only - Build sequential-only libscotch (32+64-bit, no MPI needed)"
+	@echo ""
+	@echo "Output structure:"
+	@echo "  scotch-builds/lib32/  - Sequential & parallel libraries (32-bit)"
+	@echo "  scotch-builds/lib64/  - Sequential & parallel libraries (64-bit)"
+	@echo "  scotch-builds/inc32/  - Headers (32-bit: SCOTCH_Num = int)"
+	@echo "  scotch-builds/inc64/  - Headers (64-bit: SCOTCH_Num = int64_t)"
+	@echo ""
+	@echo "Other targets:"
+	@echo "  make install         - Install Python package"
+	@echo "  make test            - Run tests (64-bit parallel, skips hypothesis)"
+	@echo "  make test-full       - Run full test suite including hypothesis"
+	@echo "  make test-quadrant   - Run all 4 variants (32/64 × seq/parallel) with hypothesis"
+	@echo "  make clean           - Clean Python build artifacts"
+	@echo "  make clean-scotch    - Clean all Scotch builds"
+	@echo "  make check-submodule - Gets Scotch as a submodule"
+	@echo ""
+
+# Build all variants
+all: build-all
+
+build-all: build-32 build-64
+	@echo ""
+	@echo "✓ All Scotch variants built successfully!"
+	@echo "  - scotch-builds/lib32/ (sequential + parallel, 32-bit)"
+	@echo "  - scotch-builds/lib64/ (sequential + parallel, 64-bit)"
+
+# Build 32-bit variants (sequential + parallel) with suffix
+build-32: check-submodule
+	@echo "=========================================="
+	@echo "Building 32-bit Scotch with suffix '_32'"
+	@echo "=========================================="
+	@mkdir -p $(BUILDS_DIR)/lib32 $(BUILDS_DIR)/inc32
+	@cd $(SCOTCH_SRC) && $(MAKE) realclean
+	@echo ""
+	@echo "[1/3] Building sequential scotch (32-bit + suffix)..."
+	@cd $(SCOTCH_SRC) && \
+		$(MAKE) scotch CFLAGS="$$(grep '^CFLAGS' Makefile.inc | cut -d= -f2-) -DSCOTCH_NAME_SUFFIX=_32 -DSCOTCH_RENAME_ALL" || true
+	@echo ""
+	@echo "[2/3] Building parallel ptscotch (32-bit + suffix)..."
+	@cd $(SCOTCH_SRC) && \
+		$(MAKE) ptscotch CFLAGS="$$(grep '^CFLAGS' Makefile.inc | cut -d= -f2-) -DSCOTCH_NAME_SUFFIX=_32 -DSCOTCH_RENAME_ALL" || true
+	@echo ""
+	@echo "[3/3] Building PyScotch file compatibility layer (32-bit)..."
+	@$(CC) $(SHARED_FLAGS) -fPIC -O2 -o $(BUILDS_DIR)/lib32/libpyscotch_compat.$(SHARED_EXT) \
+		pyscotch/native/file_compat.c
+	@echo ""
+	@echo "Copying 32-bit libraries and headers..."
+	@cp -f $(SCOTCH_DIR)/lib/lib*scotch*.$(SHARED_EXT) $(BUILDS_DIR)/lib32/ 2>/dev/null || true
+	@cp -f $(SCOTCH_DIR)/lib/lib*scotch*.a $(BUILDS_DIR)/lib32/ 2>/dev/null || true
+	@cp -f $(SCOTCH_DIR)/include/*.h $(BUILDS_DIR)/inc32/ 2>/dev/null || true
+	@echo "✓ 32-bit build complete: scotch-builds/{lib32,inc32}/"
+
+# Build 64-bit variants (sequential + parallel) with suffix
+build-64: check-submodule
+	@echo "=========================================="
+	@echo "Building 64-bit Scotch with suffix '_64'"
+	@echo "=========================================="
+	@mkdir -p $(BUILDS_DIR)/lib64 $(BUILDS_DIR)/inc64
+	@cd $(SCOTCH_SRC) && $(MAKE) realclean
+	@echo ""
+	@echo "[1/3] Building sequential scotch (64-bit + suffix)..."
+	@cd $(SCOTCH_SRC) && \
+		$(MAKE) scotch CFLAGS="$$(grep '^CFLAGS' Makefile.inc | cut -d= -f2-) -DINTSIZE64 -DSCOTCH_NAME_SUFFIX=_64 -DSCOTCH_RENAME_ALL" || true
+	@echo ""
+	@echo "[2/3] Building parallel ptscotch (64-bit + suffix)..."
+	@cd $(SCOTCH_SRC) && \
+		$(MAKE) ptscotch CFLAGS="$$(grep '^CFLAGS' Makefile.inc | cut -d= -f2-) -DINTSIZE64 -DSCOTCH_NAME_SUFFIX=_64 -DSCOTCH_RENAME_ALL" || true
+	@echo ""
+	@echo "[3/3] Building PyScotch file compatibility layer (64-bit)..."
+	@$(CC) $(SHARED_FLAGS) -fPIC -O2 -o $(BUILDS_DIR)/lib64/libpyscotch_compat.$(SHARED_EXT) \
+		pyscotch/native/file_compat.c
+	@echo ""
+	@echo "Copying 64-bit libraries and headers..."
+	@cp -f $(SCOTCH_DIR)/lib/lib*scotch*.$(SHARED_EXT) $(BUILDS_DIR)/lib64/ 2>/dev/null || true
+	@cp -f $(SCOTCH_DIR)/lib/lib*scotch*.a $(BUILDS_DIR)/lib64/ 2>/dev/null || true
+	@cp -f $(SCOTCH_DIR)/include/*.h $(BUILDS_DIR)/inc64/ 2>/dev/null || true
+	@echo "✓ 64-bit build complete: scotch-builds/{lib64,inc64}/"
+
+# Sequential-only builds (no MPI toolchain required).
+# Used for binary wheels: builds only libscotch/libscotcherr (suffixed) plus the
+# PyScotch compat layer. Unlike build-32/build-64, failures are NOT swallowed.
+build-seq-only: build-seq-32 build-seq-64
+	@echo ""
+	@echo "✓ Sequential-only Scotch variants built successfully!"
+
+build-seq-32: check-submodule
+	@echo "=========================================="
+	@echo "Building sequential-only 32-bit Scotch ('_32' suffix)"
+	@echo "=========================================="
+	@mkdir -p $(BUILDS_DIR)/lib32 $(BUILDS_DIR)/inc32
+	@cd $(SCOTCH_SRC) && $(MAKE) realclean
+	@cd $(SCOTCH_SRC) && \
+		$(MAKE) libscotch CFLAGS="$$(grep '^CFLAGS' Makefile.inc | cut -d= -f2-) -DSCOTCH_NAME_SUFFIX=_32 -DSCOTCH_RENAME_ALL"
+	@$(CC) $(SHARED_FLAGS) -fPIC -O2 -o $(BUILDS_DIR)/lib32/libpyscotch_compat.$(SHARED_EXT) \
+		pyscotch/native/file_compat.c
+	@cp -f $(SCOTCH_DIR)/lib/libscotch.$(SHARED_EXT) $(SCOTCH_DIR)/lib/libscotcherr*.$(SHARED_EXT) $(BUILDS_DIR)/lib32/
+	@cp -f $(SCOTCH_DIR)/include/*.h $(BUILDS_DIR)/inc32/
+	@echo "✓ Sequential 32-bit build complete: scotch-builds/{lib32,inc32}/"
+
+build-seq-64: check-submodule
+	@echo "=========================================="
+	@echo "Building sequential-only 64-bit Scotch ('_64' suffix)"
+	@echo "=========================================="
+	@mkdir -p $(BUILDS_DIR)/lib64 $(BUILDS_DIR)/inc64
+	@cd $(SCOTCH_SRC) && $(MAKE) realclean
+	@cd $(SCOTCH_SRC) && \
+		$(MAKE) libscotch CFLAGS="$$(grep '^CFLAGS' Makefile.inc | cut -d= -f2-) -DINTSIZE64 -DSCOTCH_NAME_SUFFIX=_64 -DSCOTCH_RENAME_ALL"
+	@$(CC) $(SHARED_FLAGS) -fPIC -O2 -o $(BUILDS_DIR)/lib64/libpyscotch_compat.$(SHARED_EXT) \
+		pyscotch/native/file_compat.c
+	@cp -f $(SCOTCH_DIR)/lib/libscotch.$(SHARED_EXT) $(SCOTCH_DIR)/lib/libscotcherr*.$(SHARED_EXT) $(BUILDS_DIR)/lib64/
+	@cp -f $(SCOTCH_DIR)/include/*.h $(BUILDS_DIR)/inc64/
+	@echo "✓ Sequential 64-bit build complete: scotch-builds/{lib64,inc64}/"
+
+# Check if scotch submodule exists and apply patches
+check-submodule:
+	@if [ ! -d "$(SCOTCH_DIR)" ] || [ ! -f "$(SCOTCH_DIR)/README.md" ]; then \
+		echo "Scotch submodule not initialized. Initializing..."; \
+		git submodule update --init --recursive; \
+		echo "✓ Submodule initialized"; \
+	fi
+	@if [ ! -f "$(SCOTCH_SRC)/Makefile.inc" ]; then \
+		echo "Creating default Makefile.inc..."; \
+		cp patches/Makefile.inc.default $(SCOTCH_SRC)/Makefile.inc; \
+		echo "✓ Makefile.inc created"; \
+	fi
+	@echo "✓ Submodule ready"
+
+# Install Python package
+install:
+	pip install -e .
+
+# Run tests (64-bit parallel by default, skip slow hypothesis tests)
+test:
+	PYSCOTCH_INT_SIZE=64 PYSCOTCH_PARALLEL=1 pytest tests/ -v --ignore=tests/hypothesis/
+
+# Run full test suite including hypothesis property tests
+test-full:
+	PYSCOTCH_INT_SIZE=64 PYSCOTCH_PARALLEL=1 pytest tests/ -v
+
+# Run all 4 variants (32/64-bit × sequential/parallel) with hypothesis
+test-quadrant:
+	@echo "========================================"
+	@echo "[1/4] Testing 32-bit sequential"
+	@echo "========================================"
+	PYSCOTCH_INT_SIZE=32 PYSCOTCH_PARALLEL=0 pytest tests/ -v
+	@echo ""
+	@echo "========================================"
+	@echo "[2/4] Testing 32-bit parallel"
+	@echo "========================================"
+	PYSCOTCH_INT_SIZE=32 PYSCOTCH_PARALLEL=1 pytest tests/ -v
+	@echo ""
+	@echo "========================================"
+	@echo "[3/4] Testing 64-bit sequential"
+	@echo "========================================"
+	PYSCOTCH_INT_SIZE=64 PYSCOTCH_PARALLEL=0 pytest tests/ -v
+	@echo ""
+	@echo "========================================"
+	@echo "[4/4] Testing 64-bit parallel"
+	@echo "========================================"
+	PYSCOTCH_INT_SIZE=64 PYSCOTCH_PARALLEL=1 pytest tests/ -v
+	@echo ""
+	@echo "✓ All 4 variants tested successfully!"
+
+# Clean Python build artifacts
+clean:
+	rm -rf build/ dist/ *.egg-info
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete
+	find . -type f -name "*.pyo" -delete
+
+# Clean Scotch builds
+clean-scotch:
+	@if [ -f "$(SCOTCH_SRC)/Makefile" ]; then \
+		cd $(SCOTCH_SRC) && $(MAKE) realclean; \
+	fi
+	rm -rf $(BUILDS_DIR)
+	rm -rf lib lib32 lib64 include include32 include64
+
+# Full clean
+distclean: clean clean-scotch
+	rm -rf $(SCOTCH_DIR)