Update from master

.claude/commands/review-pending-prs.md

@@ -0,0 +1,70 @@
+---
+description: Review pending PRs against CONTRIBUTING.md acceptance criteria.
+allowed-tools: Bash(gh api:*), Bash(gh pr close:*), Bash(gh pr diff:*), Bash(gh pr edit:*), Bash(gh pr list:*)
+---
+
+## Usage
+
+```
+/review-pending-prs
+```
+
+## Instructions
+
+1. Fetch 10 open PRs with details: `gh pr list --repo vinta/awesome-python --limit 10 --search "-label:\"claude reviewed\"" --json number,title,author,url,body,files,mergeable,mergeStateStatus`
+2. Fetch all PR diffs in parallel: `gh pr diff <number> --repo vinta/awesome-python`
+3. Run quick rejection checks (no API calls needed):
+   - Has merge conflicts? (from `mergeable`/`mergeStateStatus`)
+   - Adds more than one project? (from diff)
+   - Duplicate entry? (from diff - URL already in README)
+   - Not a project submission? (from diff - e.g., random files, contributor list)
+4. For PRs passing quick checks, fetch repo stats: `gh api repos/<owner>/<repo> --jq '{stars: .stargazers_count, created: .created_at, updated: .pushed_at, language: .language, archived: .archived}'`
+5. Review against all criteria in [CONTRIBUTING.md](../../CONTRIBUTING.md)
+6. Present summary table with recommendations
+7. Ask user:
+
+```
+Would you like me to:
+
+1. Close the rejected PRs with comments?
+2. Add "claude reviewed" label to the passed PRs?
+3. Do all
+```
+
+## Quick Rejection Checks
+
+Check these rules first - if any fail, recommend rejection:
+
+- PR has merge conflicts
+- Add more than one project per PR
+- Duplicate of existing entry
+- 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 AND not justified as a hidden gem
+- Too niche — a thin wrapper, single-function utility, or narrow edge-case tool that most Python developers would never need
+
+## Output Format
+
+Provide a simple review:
+
+1. **Rejection Check** - table with the above rules and PASS/REJECT
+2. **Recommendation** - PASS or REJECT
+
+## Close PRs
+
+If user asks to close/reject:
+
+```bash
+gh pr close <number> --repo vinta/awesome-python --comment "<brief reason>"
+```
+
+## Mark as Passed
+
+```bash
+gh pr edit <number> --repo vinta/awesome-python --add-label "claude reviewed"
+```
+
+## Extra Instructions (If Provided)
+
+$ARGUMENTS

.claude/settings.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh api:*)",
+      "Bash(gh pr close:*)",
+      "Bash(gh pr comment:*)",
+      "Bash(gh pr diff:*)",
+      "Bash(gh pr edit:*)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh run list:*)",
+      "Bash(gh run rerun:*)",
+      "Bash(gh run view:*)",
+      "Bash(gh search:*)"
+    ],
+    "deny": []
+  }
+}

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,7 +1,24 @@
-## Why this framework/library/software/resource is awesome?
+## Project
 
-A few sentences describing the reason.
+[Project Name](url)
 
-## Vote for this pull request
+## Checklist
 
-Who agrees that this change should be merged could add your reactions (e.g. :+1:) to this pull request.
+- [ ] One project per PR
+- [ ] PR title format: `Add project-name`
+- [ ] Entry format: `- [project-name](url) - Description ending with period.`
+- [ ] Description is concise and short
+
+## Why This Project Is Awesome
+
+Which criterion does it meet? (pick one)
+
+- [ ] **Industry Standard** - The go-to tool for a specific use case
+- [ ] **Rising Star** - 5000+ stars in < 2 years, significant adoption
+- [ ] **Hidden Gem** - Exceptional quality, solves niche problems elegantly
+
+Explain:
+
+## How It Differs
+
+If similar entries exist, what makes this one unique?

.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@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        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,83 @@
+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@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        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@v4
+        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@v4
+        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: Build website
+        run: make build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: website/output/
+
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,6 +1,21 @@
+# macOS
 .DS_Store
 
+# python
+.venv/
+__pycache__/
 *.py[co]
 
-docs/index.md
-site/
+# website
+website/output/
+website/data/
+
+# planning docs
+docs/
+
+# agents
+.agents/
+.claude/skills/
+.superpowers/
+.playwright-cli/
+skills-lock.json

CLAUDE.md

@@ -0,0 +1,31 @@
+# CLAUDE.md
+
+## Repository Overview
+
+An opinionated list of Python frameworks, libraries, tools, and resources. Published at [awesome-python.com](https://awesome-python.com/).
+
+## Entry Guidelines
+
+**Refer to [CONTRIBUTING.md](CONTRIBUTING.md)** for acceptance criteria, quality requirements, rejection rules, and entry format. Apply these rules whenever adding or removing an entry, whether reviewing a PR or committing directly.
+
+## Structure
+
+- **README.md**: Source of truth. Hierarchical categories with alphabetically ordered entries.
+- **CONTRIBUTING.md**: Submission guidelines and review criteria.
+- **SPONSORSHIP.md**: Sponsor tiers, placement rules, and the editorial-independence policy. Sponsor content sits in the README header and must never influence which projects get listed.
+- **website/**: Static site generator that builds awesome-python.com from README.md.
+  - `build.py`: Parses README.md and renders HTML via Jinja2 templates.
+  - `fetch_github_stars.py`: Fetches star counts into `website/data/`.
+  - `readme_parser.py`: Markdown-to-structured-data parser.
+  - `templates/`, `static/`: Jinja2 templates and CSS/JS assets.
+  - `tests/`: Pytest tests for the build pipeline.
+- **Makefile**: `make install`, `make build`, `make preview`, `make test`, `make fetch_github_stars`.
+- **pyproject.toml**: Uses `uv` for dependency management. Python >=3.13.
+
+## Key Rules
+
+- Alphabetical ordering within categories is mandatory.
+- Quality over quantity. Only "awesome" projects.
+- One project per PR.
+- One entry per commit when adding or deleting entries. Format, wording, or categorization changes across multiple entries may be bundled in a single commit.
+- README.md is the single source of content truth.