Upgrade python + dependencies and switch to UV

Author: ipmb

.github/workflows/ci_cd.yml

@@ -7,28 +7,21 @@ on:
 
 jobs:
   build:
-    env:
-      PYVER: "3.10"
 
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
 
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v1
-        with:
-          python-version: ${{ env.PYVER }}
-      - uses: pdm-project/setup-pdm@main
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
         with:
-          python-version: ${{ env.PYVER }}
-      - uses: actions/cache@v1
+          python-version-file: "pyproject.toml"
+
+      - uses: astral-sh/setup-uv@v6
         with:
-          path: ~/.cache/pip
-          key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
-          restore-keys: |
-            ${{ runner.os }}-pip-
+          enable-cache: true
 
       - name: Install dependencies
-        run: pdm sync
+        run: uv sync --locked
 
       - name: CLI docs
         run: |
@@ -40,13 +33,13 @@ jobs:
           ./apppack docgen --directory src/command-line-reference
       - name: Build
         run: APPPACK_VERSION=$(./apppack version) make build
-      - uses: actions/upload-artifact@v2
+      - uses: actions/upload-artifact@v5
         with:
           path: public
           retention-days: 3
   deploy:
     needs: [build]
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     if: github.ref == 'refs/heads/deploy/prod'
     environment: production
     env:
@@ -56,10 +49,10 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/download-artifact@v2
+      - uses: actions/checkout@v5
+      - uses: actions/download-artifact@v5
       - name: Configure AWS Credentials
-        uses: aws-actions/configure-aws-credentials@master
+        uses: aws-actions/configure-aws-credentials@v5
         with:
           role-to-assume: ${{ env.AWS_ROLE_ARN }}
           aws-region: ${{ env.AWS_DEFAULT_REGION }}

Makefile

@@ -1,6 +1,6 @@
 .PHONY: build
 build:
-	SITE_URL=https://docs.apppack.io/ pdm run mkdocs build
+	SITE_URL=https://docs.apppack.io/ uv run mkdocs build
 
 .PHONY: deploy
 deploy:
@@ -11,3 +11,11 @@ deploy:
 .PHONY: clean
 clean:
 	rm -rf ./public/*
+
+.PHONY: cli-docs
+cli-docs:
+	apppack docgen --directory src/command-line-reference
+
+.PHONY: run
+run:
+	uv run mkdocs serve

README.md

@@ -2,14 +2,14 @@
 
 To build locally, you'll need:
 
-* Python 3.9
-* [PDM](https://pdm.fming.dev/#installation)
+* Python 3.14
+* [`uv`](https://docs.astral.sh/uv/getting-started/installation/)
 
 Run:
 
 ```shell
-pdm sync
-pdm run mkdocs serve
+uv sync
+make run
 ```
 
 ## Deployment

mkdocs.yml

@@ -13,8 +13,8 @@ markdown_extensions:
   - pymdownx.tabbed:
       alternate_style: true
   - pymdownx.emoji:
-      emoji_index: !!python/name:materialx.emoji.twemoji
-      emoji_generator: !!python/name:materialx.emoji.to_svg
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
   - tables
 plugins:
   - search
@@ -25,6 +25,8 @@ repo_url: https://github.com/apppackio/apppack-docs/
 edit_uri: edit/main/src/
 extra_css:
   - stylesheets/extra.css
+exclude_docs: |
+  _navigation.md
 theme:
   name: material
   custom_dir: theme_overrides
@@ -34,3 +36,6 @@ theme:
   favicon: assets/favicon.ico
   icon:
     repo: fontawesome/brands/github
+validation:
+  links:
+    absolute_links: relative_to_docs