feat(CI): 👷 Create a reusable workflow for UV and make UV lockfile frozen

.github/actions/sync-uv/action.yml

@@ -0,0 +1,67 @@
+name: 'Sync UV Action'
+description: 'Install and sync UV with specified groups and extras'
+author: 'Pycord Development <admin@pycord.dev>'
+inputs:
+  groups:
+    description: "Comma-separated list of groups to sync"
+    required: false
+    default: ''
+  extras:
+    description: "Comma-separated list of extras to sync"
+    required: false
+    default: ''
+  frozen:
+    description: "Whether to sync with frozen dependencies"
+    required: false
+    default: 'true'
+  no_python_downloads:
+    description: "Whether to avoid downloading Python versions"
+    required: false
+    default: 'true'
+
+runs:
+  using: "composite"
+  steps:
+    - name: "Install uv"
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+
+    - name: "Run UV sync"
+      shell: bash
+      run: |
+        cmd_args=("uv" "sync")
+
+        # groups
+        set +e
+        if [ -n "${{ inputs.groups }}" ]; then
+          IFS=',' read -ra PARSED_GROUPS <<< "${{ inputs.groups }}"
+          for group in "${PARSED_GROUPS[@]}"; do
+            group=$(echo "$group" | xargs)
+            if [ -n "$group" ]; then
+              cmd_args+=("--group" "$group")
+            fi
+          done
+        fi
+        set -e
+        echo "Groups: ${PARSED_GROUPS[*]}"
+
+        # extras
+        set +e
+        if [ -n "${{ inputs.extras }}" ]; then
+          IFS=',' read -ra PARSED_EXTRAS <<< "${{ inputs.extras }}"
+          for extra in "${PARSED_EXTRAS[@]}"; do
+            extra=$(echo "$extra" | xargs)
+            if [ -n "$extra" ]; then
+              cmd_args+=("--extra" "$extra")
+            fi
+          done
+        fi
+        set -e
+        echo "Extras: ${PARSED_EXTRAS[*]}"
+
+        echo "Executing: ${cmd_args[*]}"
+        "${cmd_args[@]}"
+      env:
+        UV_NO_PYTHON_DOWNLOADS: ${{ inputs.no_python_downloads == 'true' && '1' || '' }}
+        UV_FROZEN: ${{ inputs.frozen == 'true' && '1' || '' }}

.github/workflows/docs-checks.yml

@@ -41,12 +41,10 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
-      - name: "Install uv"
-        uses: astral-sh/setup-uv@v6
+      - name: "Setup UV"
+        uses: ./.github/actions/sync-uv
         with:
-          enable-cache: true
-      - name: Sync dependencies
-        run: uv sync --no-python-downloads --group dev --group docs
+          groups: 'dev,docs'
       - name: "Check Links"
         env:
           SPHINXBUILD: ${{ github.workspace }}/.venv/bin/sphinx-build

.github/workflows/docs-localization-download.yml

@@ -20,12 +20,11 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
-      - name: "Install uv"
-        uses: astral-sh/setup-uv@v6
+      - name: "Setup UV"
+        uses: ./.github/actions/sync-uv
         with:
-          enable-cache: true
-      - name: Sync dependencies
-        run: uv sync --no-python-downloads --group dev --group docs --extra speed --extra voice
+          groups: 'dev,docs'
+          extras: 'speed,voice'
       - name: "Get locales"
         env:
           SPHINXBUILD: ${{ github.workspace }}/.venv/bin/sphinx-build

.github/workflows/docs-localization-upload.yml

@@ -25,12 +25,11 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
-      - name: "Install uv"
-        uses: astral-sh/setup-uv@v6
+      - name: "Setup UV"
+        uses: ./.github/actions/sync-uv
         with:
-          enable-cache: true
-      - name: Sync dependencies
-        run: uv sync --no-python-downloads --group dev --group docs --extra speed --extra voice
+          groups: 'dev,docs'
+          extras: 'speed,voice'
       - name: "Get locales"
         env:
           SPHINXBUILD: ${{ github.workspace }}/.venv/bin/sphinx-build

.github/workflows/lib-checks.yml

@@ -33,16 +33,10 @@ jobs:
     steps:
       - name: "Checkout Repository"
         uses: actions/checkout@v5
-      - name: "Setup Python"
-        uses: actions/setup-python@v6
-        with:
-          python-version: "3.13"
-      - name: "Install uv"
-        uses: astral-sh/setup-uv@v6
+      - name: "Setup UV"
+        uses: ./.github/actions/sync-uv
         with:
-          enable-cache: true
-      - name: Sync dependencies
-        run: uv sync --no-python-downloads --group dev
+          groups: 'dev'
       - name: "Run codespell"
         run:
           uv run codespell --ignore-words-list="groupt,nd,ot,ro,falsy,BU" \
@@ -56,12 +50,10 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
-      - name: "Install uv"
-        uses: astral-sh/setup-uv@v6
+      - name: "Setup UV"
+        uses: ./.github/actions/sync-uv
         with:
-          enable-cache: true
-      - name: Sync dependencies
-        run: uv sync --no-python-downloads --group dev
+          groups: 'dev'
       - name: "Run ruff linter check"
         run: uv run ruff check discord/
       - name: "Run ruff formatter check"
@@ -76,12 +68,10 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
-      - name: "Install uv"
-        uses: astral-sh/setup-uv@v6
+      - name: "Setup UV"
+        uses: ./.github/actions/sync-uv
         with:
-          enable-cache: true
-      - name: Sync dependencies
-        run: uv sync --no-python-downloads --group dev
+          groups: 'dev'
       - name: "Setup cache"
         id: cache-mypy
         uses: actions/cache@v4

.github/workflows/sync-guild-features.yml

@@ -24,12 +24,10 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
-      - name: "Install uv"
-        uses: astral-sh/setup-uv@v6
+      - name: "Setup UV"
+        uses: ./.github/actions/sync-uv
         with:
-          enable-cache: true
-      - name: Sync dependencies
-        run: uv sync --no-python-downloads --group dev --group ci
+          groups: 'dev,ci'
       - name: "Run guild features sync"
         run: uv run python -m scripts.sync_guild_features
         env: