build: always use uv for dependency management (#265)

Modifies the build tooling to always use `uv pip` instead of `pip` and `uv build` instead of `python -m build`.

Additional checks are added to ensure that `uv` exists on the system. If
`uv` does not exists, then it is installed via `pip`. If `pip` is not
installed, it is installed via `python -m ensurepip`. The `pip` check is
required for a virtual environment created by `uv venv` since by
default, `uv venv` does not install `pip`.

The UV_SYSTEM_PYTHON environment variable is set in CI and Docker to
force `uv` to use the system Python environment instead of depending on
a virtual environment. See
https://docs.astral.sh/uv/configuration/environment/

This reduces the execution time of `make` from 22s to 5s on my machine
without a Pip cache. With a hydrated PIp cache, the execution time is
reduced from 8s to 4s.

.github/workflows/ci.yaml

@@ -4,6 +4,8 @@ on:
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
+env:
+  UV_SYSTEM_PYTHON: true
 jobs:
   lint:
     runs-on: ubuntu-latest

.github/workflows/coverage.yaml

@@ -4,6 +4,8 @@ on:
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
+env:
+  UV_SYSTEM_PYTHON: true
 jobs:
   cov:
     runs-on: ubuntu-latest

.github/workflows/release.yaml

@@ -3,6 +3,8 @@ on:
   push:
     tags:
       - "v*.*.*"
+env:
+  UV_SYSTEM_PYTHON: true
 jobs:
   default:
     runs-on: ubuntu-latest

.github/workflows/site.yaml

@@ -4,6 +4,8 @@ on:
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
+env:
+  UV_SYSTEM_PYTHON: true
 jobs:
   preview:
     runs-on: ubuntu-latest

Dockerfile

@@ -1,5 +1,7 @@
 FROM python:3
 
+ENV UV_SYSTEM_PYTHON=true
+
 RUN apt-get update && apt-get install -y make
 
 WORKDIR /sdk

Makefile

@@ -2,21 +2,21 @@ include vars.mk
 
 .DEFAULT_GOAL := all
 
-.PHONY: build clean cov default deps dev docs fmt fix install it lint test uninstall version help
+.PHONY: build clean cov default deps dev docs ensure-uv fmt fix install it lint test uninstall version help
 
 all: deps dev test lint build
 
 build:
-	$(PYTHON) -m build
+	$(UV) build
 
 clean:
 	$(MAKE) -C ./docs $@
 	$(MAKE) -C ./integration $@
 	rm -rf .coverage .mypy_cache .pytest_cache .ruff_cache *.egg-info build coverage.xml dist htmlcov coverage.xml
+	find src -name "_version.py" -exec rm -rf {} +
 	find . -name "*.egg-info" -exec rm -rf {} +
 	find . -name "*.pyc" -exec rm -f {} +
 	find . -name "__pycache__" -exec rm -rf {} +
-	find . -name "_version.py" -exec rm -rf {} +
 	find . -type d -empty -delete
 
 cov:
@@ -29,21 +29,29 @@ cov-html:
 cov-xml:
 	$(PYTHON) -m coverage xml
 
-deps:
-	$(PIP) install --upgrade pip setuptools wheel -r requirements.txt -r requirements-dev.txt
+deps: ensure-uv
+	$(UV) pip install --upgrade pip setuptools wheel -r requirements.txt -r requirements-dev.txt
 
-dev:
-	$(PIP) install -e .
+dev: ensure-uv
+	$(UV) pip install -e .
 
 docs:
 	$(MAKE) -C ./docs
 
+ensure-uv:
+	@if ! command -v $(UV) >/dev/null 2>&1; then \
+		if ! command -v pip >/dev/null 2>&1; then \
+			$(PYTHON) -m ensurepip; \
+		fi; \
+		$(PYTHON) -m pip install uv; \
+	fi
+
 fmt:
 	$(PYTHON) -m ruff check --fix
 	$(PYTHON) -m ruff format .
 
-install:
-	$(PIP) install dist/*.whl
+install: ensure-uv
+	$(UV) pip install dist/*.whl
 
 it:
 	$(MAKE) -C ./integration
@@ -55,8 +63,8 @@ lint:
 test:
 	$(PYTHON) -m coverage run --source=src -m pytest tests
 
-uninstall:
-	$(PIP) uninstall $(NAME)
+uninstall: ensure-uv
+	$(UV) pip uninstall $(NAME)
 
 version:
 	@$(PYTHON) -m setuptools_scm

docs/Makefile

@@ -28,7 +28,7 @@ clean:
 	find . -type d -empty -delete
 
 deps:
-	$(PIP) install --upgrade pip -r requirements-site.txt
+	$(UV) pip install --upgrade pip -r requirements-site.txt
 	$(QUARTO) add --no-prompt posit-dev/[email protected]
 	$(QUARTO) add --no-prompt machow/quartodoc
 

requirements-dev.txt

@@ -10,3 +10,4 @@ rsconnect-python
 ruff
 setuptools
 setuptools-scm
+uv

vars.mk

@@ -18,7 +18,7 @@ ENV ?= dev
 
 IMAGE_TAG ?= $(NAME):latest
 
-NAME := posit-sdk-py
+NAME := posit-sdk
 
 ifeq ($(ENV), prod)
     NETLIFY_ARGS := --prod
@@ -28,20 +28,12 @@ endif
 
 NETLIFY_SITE_ID ?= 5cea1f56-7935-4387-975a-18a7905d15ee
 
-ifneq ($(shell command -v uv 2>/dev/null),)
-PYTHON := python
-else
-PYTHON := python3
-endif
-
-ifneq ($(shell command -v uv 2>/dev/null),)
-PIP := uv pip
-else
-PIP := pip3
-endif
-
-SHELL := /bin/bash
+PYTHON := $(shell command -v python || command -v python3)
 
 QUARTO ?= quarto
 
 QUARTODOC ?= quartodoc
+
+SHELL := /bin/bash
+
+UV := uv