Merge pull request #2969 from vinta/feature/relaunch-website

Relaunch website with custom build system

Author: vinta

.github/workflows/deploy-website.yml

@@ -0,0 +1,48 @@
+name: Deploy Website
+
+on:
+  push:
+    branches:
+      - master
+
+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 --no-dev
+
+      - name: Build site
+        run: uv run python website/build.py
+
+      - 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: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

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

Makefile

@@ -1,14 +1,17 @@
+-include .env
+export
+
 site_install:
-	pip install -r requirements.txt
+	uv sync --no-dev
 
-site_link:
-	ln -sf $(CURDIR)/README.md $(CURDIR)/docs/index.md
+site_fetch_stats:
+	uv run python website/fetch_github_stars.py
 
-site_preview: site_link
-	mkdocs serve
+site_build:
+	uv run python website/build.py
 
-site_build: site_link
-	mkdocs build
+site_preview: site_build
+	python -m http.server -d website/output/ 8000
 
-site_deploy: site_link
-	mkdocs gh-deploy --clean
+site_deploy: site_build
+	@echo "Deploy via GitHub Actions (push to master)"

README.md

@@ -1,6 +1,6 @@
 # Awesome Python
 
-An opinionated list of awesome Python frameworks, libraries, software and resources.
+An opinionated list of awesome Python frameworks, libraries, tools, software and resources.
 
 > The **#10 most-starred repo on GitHub**. Put your product where Python developers discover tools. [Become a sponsor](SPONSORSHIP.md).
 
@@ -87,9 +87,6 @@ An opinionated list of awesome Python frameworks, libraries, software and resour
 - [Web Frameworks](#web-frameworks)
 - [WebSocket](#websocket)
 - [WSGI Servers](#wsgi-servers)
-- [Resources](#resources)
-  - [Newsletters](#newsletters)
-  - [Podcasts](#podcasts)
 
 ---
 
@@ -534,7 +531,6 @@ _Libraries for Python version and virtual environment management._
 
 - [pyenv](https://github.com/pyenv/pyenv) - Simple Python version management.
 - [pyenv-win](https://github.com/pyenv-win/pyenv-win) - Pyenv for Windows, Simple Python version management.
-- [uv](https://github.com/astral-sh/uv) - An extremely fast Python package and project manager, written in Rust.
 - [virtualenv](https://github.com/pypa/virtualenv) - A tool to create isolated Python environments.
 
 ## File Manipulation

docs/CNAME

@@ -0,0 +1,23 @@
+[project]
+name = "awesome-python"
+version = "0.1.0"
+description = "An opinionated list of awesome Python frameworks, libraries, software and resources."
+requires-python = ">=3.13"
+dependencies = [
+    "httpx==0.28.1",
+    "jinja2==3.1.6",
+    "markdown==3.10.2",
+]
+
+[dependency-groups]
+dev = [
+    "pytest==9.0.2",
+    "ruff==0.15.6",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["website/tests"]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 100