Merge pull request #46 from MHoroszowski/feature/modernization-uv-migration

Feature/modernization uv migration

Author: MHoroszowski

.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,5 @@ _scratch/
 /spec/gen_spec/spec*.db
 tags
 /tests/debug.py
+/uat/
+/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/"