Merge branch 'vinta:master' into 2Master

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --group build --locked
+
+      - name: Run tests
+        run: make test
+
+      - name: Build website
+        run: make build

.github/workflows/deploy-website.yml

@@ -0,0 +1,105 @@
+name: Deploy Website
+
+on:
+  push:
+    branches: [master]
+  schedule:
+    - cron: "0 0 * * *"
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    if: github.repository == 'vinta/awesome-python'
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: https://awesome-python.com/
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          # build.py reads each page's last change from git history for the sitemap's lastmod
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --group build --locked
+
+      - name: Run tests
+        if: github.event_name == 'schedule'
+        run: make test
+
+      - name: Get date
+        id: date
+        run: echo "today=$(date -u +%Y-%m-%d)" >> "$GITHUB_OUTPUT"
+
+      - name: Restore star data cache
+        id: cache-stars
+        uses: actions/cache/restore@v6
+        with:
+          path: website/data/github_stars.json
+          key: github-stars-${{ steps.date.outputs.today }}
+          restore-keys: github-stars-
+
+      - name: Fetch GitHub stars
+        id: fetch-stars
+        continue-on-error: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: make fetch_github_stars
+
+      - name: Save star data cache
+        if: steps.fetch-stars.outcome == 'success'
+        uses: actions/cache/save@v6
+        with:
+          path: website/data/github_stars.json
+          key: github-stars-${{ steps.date.outputs.today }}
+
+      - name: Verify star data exists
+        run: |
+          if [ ! -f website/data/github_stars.json ]; then
+            echo "::error::github_stars.json not found. No cache and fetch failed or was skipped."
+            exit 1
+          fi
+          python -m json.tool website/data/github_stars.json > /dev/null
+
+      - name: Restore PyPI download data cache
+        uses: actions/cache/restore@v6
+        with:
+          path: website/data/pypi_downloads.tsv
+          key: pypi-downloads-${{ steps.date.outputs.today }}
+          restore-keys: pypi-downloads-
+
+      - name: Fetch PyPI downloads
+        id: fetch-downloads
+        continue-on-error: true
+        run: make fetch_pypi_downloads
+
+      - name: Save PyPI download data cache
+        if: steps.fetch-downloads.outcome == 'success'
+        uses: actions/cache/save@v6
+        with:
+          path: website/data/pypi_downloads.tsv
+          key: pypi-downloads-${{ steps.date.outputs.today }}
+
+      - name: Build website
+        run: make build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: website/output/
+
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v5