[pull] master from vinta:master

.github/workflows/deploy-website.yml

@@ -0,0 +1,80 @@
+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:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --group build
+
+      - name: Restore star data cache
+        id: cache-stars
+        uses: actions/cache/restore@v4
+        with:
+          path: website/data/github_stars.json
+          key: github-stars-${{ github.run_id }}
+          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@v4
+        with:
+          path: website/data/github_stars.json
+          key: github-stars-${{ github.run_id }}
+
+      - 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
+          echo "Star data found: $(wc -l < website/data/github_stars.json) lines"
+
+      - name: Build site
+        run: make build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: website/output/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: https://awesome-python.com/
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,9 +1,16 @@
+# macOS
 .DS_Store
 
+# python
+.venv/
 *.py[co]
 
-docs/index.md
-site/
+# website
+website/output/
+website/data/
 
-# PyCharm IDE
-.idea
+# claude code
+.claude/skills/
+.superpowers/
+.gstack/
+skills-lock.json

CONTRIBUTING.md

@@ -1,18 +1,5 @@
 # Contributing
 
-## Automatic Rejection
-
-PRs will be **closed** if:
-
-- Adding multiple projects in one PR
-- Duplicate of existing entry or recently-closed PR
-- Empty or placeholder PR descriptions
-- Placed under an inappropriate category
-- Project is archived or abandoned (no commits in 12+ months)
-- No documentation or unclear use case
-- Less than 100 GitHub stars without Hidden Gem justification
-- Repository less than 3 months old
-
 ## Quality Requirements
 
 All submissions must satisfy **ALL** of these:
@@ -31,15 +18,15 @@ Your submission must meet **ONE** of the following criteria:
 ### 1. Industry Standard
 
 - The go-to tool that almost everyone uses for a specific use case
-- Examples: Requests, Flask, Pandas, NumPy
+- Examples: requests, flask, pandas, numpy
 - Limit: 1-3 tools per category
 
 ### 2. Rising Star
 
 - Rapid growth: 5,000+ GitHub stars in less than 2 years
 - Significant community buzz and adoption
 - Solving problems in new or better ways
-- Examples: FastAPI, Ruff, uv
+- Examples: fastapi, ruff, uv
 
 ### 3. Hidden Gem
 
@@ -52,10 +39,16 @@ Your submission must meet **ONE** of the following criteria:
 
 ## Entry Format Reference
 
+**Use GitHub repository URLs** whenever possible. Projects linked to a GitHub repo are ranked higher on [awesome-python.com](https://awesome-python.com/).
+
+### Naming Convention
+
+Use the **PyPI package name** as the display name so developers can copy it directly to `pip install`. Check the canonical name at `https://pypi.org/pypi/{package}/json`. If the project is not on PyPI, use the GitHub repository name instead.
+
 ### Standard Entry
 
 ```markdown
-- [project-name](https://github.com/owner/repo) - Description ending with period.
+- [pypi-name](https://github.com/owner/repo) - Description ending with period.
 ```
 
 ### Standard Library Module
@@ -87,8 +80,9 @@ Your submission must meet **ONE** of the following criteria:
 ## Adding a New Section
 
 1. Add section description in italics: `*Libraries for doing X.*`
-2. Add the section title to the Table of Contents
-3. Keep sections in alphabetical order
+2. Add the section under the appropriate thematic group (e.g., **AI & ML**, **Web**, **Data & Science**)
+3. Add the section title to the Table of Contents under its group
+4. Keep entries in alphabetical order within each category
 
 ## Review Process
 
@@ -101,3 +95,16 @@ PRs are reviewed by automated tools and maintainers:
 5. **Quality Check**: Meets acceptance criteria
 
 Search previous Pull Requests and Issues before submitting, as yours may be a duplicate.
+
+## Automatic Rejection
+
+PRs will be **closed** if:
+
+- Adding multiple projects in one PR
+- Duplicate of existing entry or recently-closed PR
+- Empty or placeholder PR descriptions
+- Placed under an inappropriate category
+- Project is archived or abandoned (no commits in 12+ months)
+- No documentation or unclear use case
+- Less than 100 GitHub stars without Hidden Gem justification
+- Repository less than 3 months old

Makefile

@@ -1,14 +1,24 @@
-site_install:
-	pip install -r requirements.txt
+-include .env
+export
 
-site_link:
-	ln -sf $(CURDIR)/README.md $(CURDIR)/docs/index.md
+install:
+	uv sync
 
-site_preview: site_link
-	mkdocs serve
+fetch_github_stars:
+	uv run python website/fetch_github_stars.py
 
-site_build: site_link
-	mkdocs build
+test:
+	uv run pytest website/tests/ -v
 
-site_deploy: site_link
-	mkdocs gh-deploy --clean
+build:
+	uv run python website/build.py
+
+preview: build
+	@echo "Check the website on http://localhost:8000"
+	uv run watchmedo shell-command \
+		--patterns='*.md;*.html;*.css;*.js;*.py' \
+		--recursive \
+		--wait --drop \
+		--command='uv run python website/build.py' \
+		README.md website/templates website/static website/data & \
+	python -m http.server -b 127.0.0.1 -d website/output/ 8000