MAINT: Fully embrace uv locally and on CI

Author: has2k1

.github/workflows/testing.yml

@@ -29,18 +29,10 @@ jobs:
       - name: Checkout Code
         uses: actions/checkout@v4
 
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v6
         with:
-          version: "latest"
-
-      - name: Make uv use system python
-        run: echo "UV_SYSTEM_PYTHON=true" >> $GITHUB_ENV
+          python-version: ${{ matrix.python-version }}
 
       - name: Install Packages
         # Install as an editable so that the coverage path is predicable
@@ -81,12 +73,9 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v6
         with:
-          version: "latest"
-
-      - name: Make uv use system python
-        run: echo "UV_SYSTEM_PYTHON=true" >> $GITHUB_ENV
+          python-version: ${{ matrix.python-version }}
 
       - name: Install Linting & Formatting Packages
         run: uv pip install ruff
@@ -121,12 +110,9 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v6
         with:
-          version: "latest"
-
-      - name: Make uv use system python
-        run: echo "UV_SYSTEM_PYTHON=true" >> $GITHUB_ENV
+          python-version: ${{ matrix.python-version }}
 
       - name: Install Packages
         run: uv pip install ".[extra, typing]"
@@ -158,12 +144,9 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v6
         with:
-          version: "latest"
-
-      - name: Make uv use system python
-        run: echo "UV_SYSTEM_PYTHON=true" >> $GITHUB_ENV
+          python-version: ${{ matrix.python-version }}
 
       - name: Install Packages
         run: uv pip install -e ".[doc]"

.gitignore

@@ -59,4 +59,7 @@ doc/generated/
 # PyBuilder
 target/
 
+# local dev things
+.local/
+
 .DS_Store

Makefile

@@ -1,5 +1,30 @@
 .PHONY: clean-pyc clean-build doc clean build
-BROWSER := python -mwebbrowser
+
+# NOTE: Take care not to use tabs in any programming flow outside the
+# make target
+
+# Use uv (if it is installed) to run all python related commands,
+# and prefere the active environment over .venv in a parent folder
+ifeq ($(OS),Windows_NT)
+  HAS_UV := $(if $(shell where uv 2>NUL),true,false)
+else
+  HAS_UV := $(if $(shell command -v uv 2>/dev/null),true,false)
+endif
+
+ifeq ($(HAS_UV),true)
+  PYTHON ?= uv run --active python
+  PIP ?= uv pip
+  UVRUN ?= uv run --active
+else
+  PYTHON ?= python
+  PIP ?= pip
+  UVRUN ?=
+endif
+
+BROWSER := $(PYTHON) -mwebbrowser
+
+all:
+	@echo "Using Python: $(PYTHON)"
 
 help:
 	@echo "clean - remove all build, test, coverage and Python artifacts"
@@ -14,17 +39,18 @@ help:
 	@echo "dist - package"
 	@echo "install - install the package to the active Python's site-packages"
 
-clean: clean-build clean-pyc clean-test
+clean: clean-build clean-cache clean-test
 
 clean-build:
 	rm -fr build/
 	rm -fr dist/
 	find . -name '*.egg-info' -exec rm -fr {} +
 
-clean-pyc:
+clean-cache:
 	find . -name '__pycache__' -exec rm -fr {} +
 
 clean-test:
+	$(UVRUN) coverage erase
 	rm -f .coverage
 	rm -f coverage.xml
 	rm -fr htmlcov/
@@ -33,55 +59,61 @@ ruff:
 	ruff check . $(args)
 
 format:
-	ruff format . --check
+	$(UVRUN) ruff format --check .
 
 format-fix:
-	ruff format .
+	$(UVRUN) ruff format .
 
-lint: ruff
+lint:
+	$(UVRUN) ruff check .
 
 lint-fix:
-	make lint args="--fix"
+	$(UVRUN) ruff check --fix .
 
 fix: format-fix lint-fix
 
 typecheck:
-	pyright
+	$(UVRUN) pyright
 
 test: clean-test
-	pytest --runslow
+	$(UVRUN) pytest --runslow
 
 test-fast: clean-test
-	pytest
+	$(UVRUN) pytest
 
 coverage:
-	coverage report -m
-	coverage html
+	$(UVRUN) coverage report -m
+	$(UVRUN) coverage html
 	$(BROWSER) htmlcov/index.html
 
+
 doc:
 	$(MAKE) -C doc clean
 	$(MAKE) -C doc html
 	$(BROWSER) doc/_build/html/index.html
 
 release-major:
-	@python ./tools/release-checklist.py major
+	@$(PYTHON) ./tools/release-checklist.py major
 
 release-minor:
-	@python ./tools/release-checklist.py minor
+	@$(PYTHON) ./tools/release-checklist.py minor
 
 release-patch:
-	@python ./tools/release-checklist.py patch
-
-build: clean
-	python -m build
+	@$(PYTHON) ./tools/release-checklist.py patch
 
-dist: build
+dist: clean-build
+	$(PYTHON) -m build
 	ls -l dist
 
-develop: clean-pyc
-	uv pip install -e ".[all]"
+build: dist
 
 install: clean
 	ls -l dist
-	uv pip install .
+	$(PIP) install .
+
+develop: clean-cache
+	$(PIP) install -e ".[all]"
+
+develop-update: clean-cache
+	$(PIP) install --upgrade -e ".[all]"
+	$(UVRUN) pre-commit autoupdate

doc/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line.
 SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
+SPHINXBUILD   = uv run sphinx-build
 SPHINXPROJ    = mizani
 SOURCEDIR     = .
 PAPER         =