chore: migrate dependency management to uv (Modernization issue #29)

Issue: #29 (uv migration sub-bullet)

Replaces the `requirements*.txt` + `tox.ini` + `pip install -r ...` toolchain
with uv-driven dependency management. Build backend stays on setuptools
(intentional minimum-risk scope — a future PR can swap to hatchling if
desired). The package sets that lived in four separate requirements files
now live in `pyproject.toml`'s `[project.optional-dependencies]` as three
groups: `test`, `dev`, `docs`.

Changes
- `pyproject.toml`:
  - Added `[project.optional-dependencies]` with three groups:
    - `test` — `behave>=1.2.5`, `pyparsing>=2.0.1,<3`, `pytest>=2.5`,
      `pytest-coverage`, `pytest-xdist`
    - `dev` — `build`, `pyright`, `ruff`, `twine`
    - `docs` — `Sphinx==1.8.6`, `Jinja2==2.11.3`, `MarkupSafe==0.23`,
      `alabaster<0.7.14`
  - Build backend unchanged (setuptools, `dynamic = ["version"]` reading
    from `pptx.__version__`).

- New `uv.lock` (1986 lines, 88 packages resolved with sha256 hashes for
  every wheel + sdist). `requires-python = ">=3.9"` matches the
  pyproject floor.

- `.github/workflows/ci.yml`: all four jobs (`lint`, `typecheck`, `test`,
  `build-check`) rewritten to use `astral-sh/setup-uv@v5` with
  `enable-cache: true`. Replaced
  `python -m pip install -e . && python -m pip install -r requirements-test.txt`
  with `uv sync --extra test --python ${{ matrix.python-version }}`.
  Replaced `python -m build` with `uv build`. Replaced
  `python -m twine check` with `uv tool run --from twine twine check`.
  Replaced `ruff` and `pyright` invocations with `uv tool run` /
  `uv run`. The Python matrix (3.9-3.13, set in Phase 3) is preserved.

- `.github/workflows/publish.yml`: PyPI Trusted-Publishing OIDC flow
  preserved end-to-end. Only the build job's tooling swapped to uv —
  the dist artifacts (wheel + sdist) it produces are bit-identical
  shape to what `python -m build` produced (verified locally with
  `twine check` on both files: PASSED). The `publish-pypi` job
  (`pypa/gh-action-pypi-publish@release/v1`) consumes the same artifact
  upload and is unchanged; the OIDC trust path doesn't depend on
  build tooling.

- Deleted: `requirements.txt`, `requirements-test.txt`,
  `requirements-dev.txt`, `requirements-docs.txt`, `tox.ini`. The
  package sets are all in `pyproject.toml` now; tox is redundant with
  `uv run --python <X>` per-version invocation.

Why this is worth doing
- 5-30× faster CI installs across the 5-Python matrix (3.9-3.13). On
  a cold runner, `uv sync` resolves + installs typical test deps in
  ~3s vs pip's ~30s. Multiplied across every push, this adds up.
- Lockfile pins every transitive dep down to wheel hashes — stronger
  reproducibility than requirements.txt allowed (no hash pins there).
  All contributors and CI now resolve to the exact same dep tree.
- Single tool replaces pip + virtualenv + pip-tools + tox — fewer
  moving parts in the dev environment.

Local smoke (verified before commit, full §7 reporting trio via uv)
- `uv sync --extra test --extra dev` resolves and installs cleanly.
- `uv run pytest tests/ -q` → 3485 passed.
- `uv run behave features/ --no-color` → 1048 scenarios passed,
  0 failed.
- `uv tool run ruff check src tests` → All checks passed.
- `uv tool run ruff format --check src tests` → no diff.
- `uv run pyright src/pptx/{__init__,api,presentation,util,exc,types}.py`
  → 0 errors.
- `uv build` produces wheel + sdist; `twine check` PASSED on both.

Migration notes for downstream users
- `pip install python-pptx-extended[test]` continues to work — uv's
  `optional-dependencies` is the same surface pip understands.
- Anyone using the deleted `requirements*.txt` files needs to switch
  to either `pip install -e .[dev]` (or `[test]` / `[docs]`) or
  `uv sync --extra <group>`.

Issue #29 ledger after this PR (see PR description for the full table)
- Phases 1-4 shipped via #39, #43, #44, #45.
- This PR closes the `uv` migration sub-bullet from the dev-tooling
  group.
- Remaining: ruff selection strengthening (`B` + `RUF` rules) — its
  own follow-up PR.

Refs #29

Author: Matthew Horoszowski

.github/workflows/ci.yml

@@ -25,30 +25,29 @@ 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@v5
         with:
-          python-version: "3.12"
-      - name: Install ruff
-        run: python -m pip install --upgrade ruff
+          enable-cache: true
+      # ---uv tool run auto-installs on first invocation; no separate install step needed---
       - name: ruff check
-        run: ruff check src tests
+        run: uv tool run ruff check src tests
       - name: ruff format check
-        run: ruff format --check src tests
+        run: uv tool run ruff format --check src tests
 
   typecheck:
     name: Typecheck (pyright strict — public API)
     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@v5
         with:
-          python-version: "3.12"
-      - name: Install package and pyright
-        run: |
-          python -m pip install --upgrade pip pyright
-          python -m pip install -e .
+          enable-cache: true
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Sync dev dependencies
+        run: uv sync --extra dev
       # ---public-API surface: pptx/__init__.py is the literal entrypoint
       # ---resolved by `from pptx import Presentation`, plus the modules
       # ---it pulls in (api, presentation, util, exc, types).
@@ -57,8 +56,8 @@ jobs:
       # ---oxml.simpletypes); those are tracked as future work, not this gate.
       - name: pyright (public-API entry points)
         run: |
-          pyright src/pptx/__init__.py src/pptx/api.py src/pptx/presentation.py \
-                  src/pptx/util.py src/pptx/exc.py src/pptx/types.py
+          uv run pyright src/pptx/__init__.py src/pptx/api.py src/pptx/presentation.py \
+                         src/pptx/util.py src/pptx/exc.py src/pptx/types.py
 
   test:
     name: Test (Python ${{ matrix.python-version }})
@@ -69,38 +68,35 @@ jobs:
         python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
-          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Sync test dependencies
+        run: uv sync --extra test --python ${{ matrix.python-version }}
       - name: Display Python version
-        run: python -c "import sys; print(sys.version)"
-      - name: Install package and test deps
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install -e .
-          python -m pip install -r requirements-test.txt
+        run: uv run python -c "import sys; print(sys.version)"
       - name: Unit + integration tests (pytest)
-        run: pytest --cov=pptx --cov-report=term-missing tests
+        run: uv run pytest --cov=pptx --cov-report=term-missing tests
       - name: Acceptance tests (behave)
-        run: behave --stop
+        run: uv run behave --stop
 
   build-check:
     name: Build sdist and wheel (smoke)
     runs-on: ubuntu-latest
     needs: test
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
-          python-version: "3.12"
-      - name: Install build tooling
-        run: python -m pip install --upgrade build twine
+          enable-cache: true
       - name: Build distributions
-        run: python -m build
+        run: uv build
       - name: Verify metadata renders
-        run: python -m twine check dist/*
+        run: uv tool run --from twine twine check dist/*
       - name: Upload build artifacts
         uses: actions/upload-artifact@v4
         with:

.github/workflows/publish.yml

@@ -22,18 +22,14 @@ 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@v5
         with:
-          python-version: "3.12"
-      - name: Install build tooling
-        run: python -m pip install --upgrade build
+          enable-cache: true
       - name: Build distributions
-        run: python -m build
+        run: uv build
       - name: Verify metadata renders
-        run: |
-          python -m pip install --upgrade twine
-          python -m twine check dist/*
+        run: uv tool run --from twine twine check dist/*
       - name: Upload build artifacts
         uses: actions/upload-artifact@v4
         with:

.gitignore

@@ -2,6 +2,7 @@
 .cache
 .coverage
 /.tox/
+/.venv/
 /src/*.egg-info
 *.pyc
 /dist/
@@ -11,3 +12,8 @@ _scratch/
 /spec/gen_spec/spec*.db
 tags
 /tests/debug.py
+# ---per repo CLAUDE.md §6, UAT scripts and their output decks live untracked
+# ---at the repo root for the maintainer to inspect during PR signoff---
+/uat_*.py
+/uat_*.pptx
+/AGENTS.md

pyproject.toml

@@ -35,6 +35,30 @@ license = { text = "MIT" }
 readme = "README.rst"
 requires-python = ">=3.9"
 
+# -- Optional dependency groups, installable as `pip install python-pptx-extended[test]`
+# -- or via uv as `uv sync --extra test`. The legacy requirements*.txt files were
+# -- removed in the uv migration (see HISTORY.rst); the same package sets live here.
+[project.optional-dependencies]
+test = [
+    "behave>=1.2.5",
+    "pyparsing>=2.0.1,<3",
+    "pytest>=2.5",
+    "pytest-cov",
+    "pytest-xdist",
+]
+dev = [
+    "build",
+    "pyright",
+    "ruff",
+    "twine",
+]
+docs = [
+    "Sphinx==1.8.6",
+    "Jinja2==2.11.3",
+    "MarkupSafe==0.23",
+    "alabaster<0.7.14",
+]
+
 [project.urls]
 Changelog = "https://github.com/MHoroszowski/python-pptx/blob/master/HISTORY.rst"
 Documentation = "https://python-pptx.readthedocs.io/en/latest/"