feat: replace pdm with uv, nox (#1362)

Author: onerandomusername

.github/PULL_REQUEST_TEMPLATE.md

@@ -8,8 +8,8 @@
 
 - [ ] If code changes were made, then they have been tested
     - [ ] I have updated the documentation to reflect the changes
-    - [ ] I have formatted the code properly by running `pdm run nox -s lint`
-    - [ ] I have type-checked the code by running `pdm run nox -s pyright`
+    - [ ] I have formatted the code properly by running `uv run nox -s lint`
+    - [ ] I have type-checked the code by running `uv run nox -s pyright`
 - [ ] This PR fixes an issue
 - [ ] This PR adds something new (e.g. new method or parameters)
 - [ ] This PR is a breaking change (e.g. methods or parameters removed/renamed)

.github/actions/cache-pdm/action.yml

@@ -5,7 +5,20 @@ description: .
 inputs:
   python-version:
     description: The python version to install
-    required: true
+    required: false
+    default: '3.8'
+  use-cached-uv-lock:
+    description: Whether to download the uv lock cache.
+    required: false
+    default: 'true'
+  update-uv-lock:
+    description: Whether to update the uv lock file. Allows the cache to fail.
+    required: false
+    default: 'false'
+  uv-resolution-strategy:
+    description: The uv resolution strategy to use. See https://docs.astral.sh/uv/reference/environment/#uv_resolution for details.
+    required: false
+    default: 'highest'
 outputs:
   python-version:
     description: The python version that was installed.
@@ -14,33 +27,52 @@ outputs:
 runs:
   using: composite
   steps:
-    - name: Set up pdm with python ${{ inputs.python-version }}
+    - name: Download uv lock
+      uses: actions/cache/restore@v4
+      if: ${{ inputs.use-cached-uv-lock != 'false' }}
+      id: restore-uv-lock
+      with:
+        key: uv-lock-resolved-${{ inputs.uv-resolution-strategy }}
+        path: uv.lock
+        restore-keys: |
+          uv-lock-resolved-${{ inputs.uv-resolution-strategy }}
+        enableCrossOsArchive: true
+        fail-on-cache-miss: ${{ inputs.update-uv-lock != 'true' }}
+
+    - name: Set up uv with python ${{ inputs.python-version }}
       id: setup-python
-      uses: pdm-project/setup-pdm@v4
+      uses: astral-sh/setup-uv@v6
       with:
-        allow-python-prereleases: true
+        version: '0.8.14'
+        enable-cache: true
+        # this doesn't install python but pins the uv version; its the same as providing UV_PYTHON
         python-version: ${{ inputs.python-version }}
-        version: "2.20.1"  # last version to support python 3.8
-        cache: false
 
-    - name: Disable PDM version check
+    - name: Install python ${{ inputs.python-version }}
       shell: bash
+      env:
+        UV_PYTHON_DOWNLOADS: automatic
       run: |
-        pdm config check_update false
+        uv python install ${{ inputs.python-version }}
 
-    - name: Ignore saved pythons
+    - name: Install nox
       shell: bash
       run: |
-        echo "PDM_IGNORE_SAVED_PYTHON=1" >> $GITHUB_ENV
+        uv tool install nox
 
-    - name: Install nox
+    - name: Lock dependencies
+      id: lock-uv-deps
+      if: ${{ inputs.update-uv-lock }}
       shell: bash
-      run: pip install nox
+      env:
+        UV_LOCKED: 0
+      run: uv lock --refresh
 
     - name: Set python version
       id: python-version
       shell: bash
-      run: echo "python-version=$(python -c 'import sys; print(".".join(map(str,sys.version_info[:2])))')" >> $GITHUB_OUTPUT
-
-    - name: Configure cache
-      uses: ./.github/actions/cache-pdm
+      env:
+        UV_VENV_CLEAR: 1
+      run: |
+        uv venv .venv
+        echo "python-version=$(uv run python -c 'import sys; print(".".join(map(str,sys.version_info[:2])))')" >> $GITHUB_OUTPUT

.github/actions/setup-env/action.yml

@@ -28,18 +28,19 @@ jobs:
           fetch-depth: '0'
 
       - name: Set up environment
+        id: setup-env
         uses: ./.github/actions/setup-env
         with:
-          python-version: '3.9'
+          update-uv-lock: true
 
       - name: Install dependencies
-        run: pdm install -dG changelog
+        run: uv sync --only-group changelog
 
       - name: Check for presence of a Change Log fragment (only pull requests)
         # NOTE: The pull request' base branch needs to be fetched so towncrier
         # is able to compare the current branch with the base branch.
         run: |
-          if ! pdm run towncrier check --compare-with origin/${BASE_BRANCH}; then
+          if ! uv run towncrier check --compare-with origin/${BASE_BRANCH}; then
             echo "::error::Please see https://github.com/DisnakeDev/disnake/blob/master/changelog/README.rst for details on how to create a changelog entry." >&2
             exit 1
           fi

.github/workflows/changelog.yaml

@@ -48,7 +48,7 @@ jobs:
           python-version: 3.8
 
       - name: Install dependencies
-        run: pdm install -dG changelog
+        run: uv sync --no-default-groups --group changelog
 
       - name: Update version
         run: |
@@ -57,7 +57,7 @@ jobs:
 
       - name: Build changelog
         run: |
-          pdm run towncrier build --yes --version "$VERSION_INPUT"
+          uv run towncrier build --yes --version "$VERSION_INPUT"
           git commit -a -m "docs: build changelog"
 
       - name: Create pull request

.github/workflows/create-release-pr.yaml

@@ -25,6 +25,10 @@ defaults:
     shell: bash
 
 env:
+  # https://docs.astral.sh/uv/reference/environment/
+  UV_LOCKED: 1
+  UV_NO_SYNC: 1
+  UV_PYTHON_DOWNLOADS: never
   GITHUB_STEP_SUMMARY_HEADER: "<details><summary>#name#</summary>\n<pre>"
   GITHUB_STEP_SUMMARY_FOOTER: "</pre></details>\n"
 
@@ -36,15 +40,48 @@ jobs:
     # while still not needing to commit a lockfile to the repo, which is discouraged for libraries as per
     # https://pdm-project.org/en/latest/usage/lockfile/
     runs-on: ubuntu-latest
+    env:
+      UV_RESOLUTION: highest
     steps:
       - uses: actions/checkout@v4
 
-    # Instead of setup-env, we call the cache-pdm action here directly.
-    # This avoids having to install PDM, only to find out the cache is already up to date sometimes.
-      - name: Configure cache
-        uses: ./.github/actions/cache-pdm
+      - name: Set up environment
+        id: setup-env
+        uses: ./.github/actions/setup-env
+        with:
+          use-cached-uv-lock: 'false' # we don't need the lock here, we will automatically download it below
+
+      - name: Restore uv lock
+        uses: actions/cache/restore@v4
+        id: cache-uv-lock
         with:
-          env-already-initialized: false
+          key: uv-lock-resolved-${{ env.UV_RESOLUTION }}
+          restore-keys: |
+            uv-lock-resolved-${{ env.UV_RESOLUTION }}
+          path: uv.lock
+          enableCrossOsArchive: true
+
+      - name: Check if uv.lock changed
+        id: uv-lock-changed
+        continue-on-error: true
+        if: steps.cache-uv-lock.outputs.cache-hit == 'true' || steps.cache-uv-lock.outputs.cache-hit == 'false'
+        run: |
+          uv lock --check
+
+      - name: Lock dependencies
+        if: steps.uv-lock-changed.outcome == 'failure' || steps.cache-uv-lock.outputs.cache-hit != 'true' && steps.cache-uv-lock.outputs.cache-hit != 'false'
+        id: lock-uv-deps
+        env:
+          UV_LOCKED: 0
+        run: uv lock --refresh
+
+      - uses: actions/cache/save@v4
+        if: steps.lock-uv-deps.outcome == 'success'
+        name: upload-uv-lock
+        with:
+          key: uv-lock-resolved-${{ env.UV_RESOLUTION }}-${{ hashFiles('uv.lock') }}
+          path: uv.lock
+          enableCrossOsArchive: true
 
   # Used to determine which python versions to test against.
   # noxfile.py is the source of truth, which in turn draws from
@@ -62,7 +99,7 @@ jobs:
       - name: Set up environment
         uses: ./.github/actions/setup-env
         with:
-          python-version: 3.8
+          use-cached-uv-lock: 'false' # we don't need the lock here
 
       - name: Determine Python versions to test and lint against
         id: set-matrix
@@ -120,7 +157,6 @@ jobs:
       - lint
     strategy:
       matrix:
-        # TODO: add 3.14 once we switch to uv
         session: ${{ fromJson(needs.python-versions.outputs.pyright-sessions) }}
       fail-fast: false
     continue-on-error: ${{ matrix.session.experimental }}
@@ -136,9 +172,9 @@ jobs:
       - name: Add .venv/bin to PATH
         id: venv-bin
         run: |
-          pdm venv create
-          dirname "$(pdm info --python)" >> $GITHUB_PATH
-          echo python="$(pdm info --python)" >> $GITHUB_OUTPUT
+          uv venv .venv
+          dirname "$(uv python find)" >> $GITHUB_PATH
+          echo python="$(uv python find)" >> $GITHUB_OUTPUT
 
       - name: Install dependencies
         # `--no-venv` to install in the main pdm venv instead of nox's pyright-specific one
@@ -196,21 +232,15 @@ jobs:
         run: |
           nox -s slotscheck
 
-      - name: Run check-manifest
-        if: (success() || failure()) && steps.setup.outcome == 'success'
-        run: nox -s check-manifest
-
-      # This only runs if the previous steps were successful, no point in running it otherwise
       - name: Try building package
+        if: (success() || failure()) && steps.setup.outcome == 'success'
         run: |
-          pdm install -dG build
-
-          pdm run python -m build
+          nox -s build
           ls -la dist/
 
       - name: Check README.md renders properly on PyPI
         run: |
-          pdm run twine check --strict dist/*
+          uvx twine~=6.1 check --strict dist/*
 
   codemod:
     runs-on: ubuntu-latest
@@ -237,7 +267,7 @@ jobs:
           if [ -n "$(git status --porcelain)" ]; then
             echo "::error::Please run 'nox -s codemod -- run-all' locally and commit the changes." >&2;
             echo "$GITHUB_STEP_SUMMARY_HEADER" | sed "s/#name#/LibCST Codemod/" >> $GITHUB_STEP_SUMMARY
-            echo "The libcst codemod made changes to the codebase. Please run 'nox -s codemod -- run-all' locally and commit the changes." >> $GITHUB_STEP_SUMMARY
+            echo "The libcst codemod made changes to the codebase. Please run 'uv run nox -s codemod -- run-all' locally and commit the changes." >> $GITHUB_STEP_SUMMARY
             echo "::group::git diff"
             git diff |& tee -a $GITHUB_STEP_SUMMARY
             echo "::endgroup::"
@@ -256,7 +286,6 @@ jobs:
     strategy:
       matrix:
         os: ["windows-latest", "ubuntu-latest", "macos-latest"]
-        # TODO: add 3.14 once we switch to uv
         session: ${{ fromJson(needs.python-versions.outputs.test-sessions) }}
       fail-fast: true
     continue-on-error: ${{ matrix.session.experimental }}
@@ -288,6 +317,7 @@ jobs:
       - name: Print Coverage Output
         if: always() && (steps.run_tests.outcome == 'success' || steps.run_tests.outcome == 'failure')
         env:
+          UV_NO_SYNC: 0
           NOXSESSION: coverage
         run: |
           echo "$GITHUB_STEP_SUMMARY_HEADER" | sed "s/#name#/Coverage Summary/" >> $GITHUB_STEP_SUMMARY

.github/workflows/lint-test.yml

@@ -25,16 +25,13 @@ jobs:
         with:
           python-version: 3.8
 
-      - name: Install dependencies
-        run: pdm install -dG build
-
       - name: Build package
         run: |
-          pdm run python -m build
+          uvx --from=build~=1.3 pyproject-build
           ls -la dist/
 
       - name: Twine check
-        run: pdm run twine check --strict dist/*
+        run: uvx twine~=6.1 check --strict dist/*
 
       - name: Show metadata
         run: |

.github/workflows/release.yaml

@@ -31,6 +31,5 @@ venvs/
 .coverage*
 coverage.xml
 __pypackages__/
-.pdm.toml
-.pdm-python
-pdm.lock
+.python-version
+uv.lock

.gitignore

@@ -7,13 +7,16 @@ build:
   os: ubuntu-24.04
   tools:
     python: "3.8"
+  jobs:
+    create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+      - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --no-default-groups --extra docs
+    install:
+      - "true"
+
 sphinx:
   configuration: docs/conf.py
   fail_on_warning: false
   builder: html
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs