Commit graph

608 commits

Author SHA1 Message Date
Vinta Chen
08f0718e60
docs: add Data Ingestion / ETL category intro
Its meta description fell back to generic text with no guidance on which library to pick.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 07:34:13 +08:00
Vinta Chen
12e4fc4962
docs: add Data Visualization category intro
Its meta description fell back to generic text with no guidance on which library to pick.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 07:34:09 +08:00
Vinta Chen
8b04838903
docs: add web asset management category intro
The page had no intro, so readers got no pick between django-storages and Django Compressor.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 06:26:25 +08:00
Vinta Chen
d7c709371f
docs: add template engines category intro
The page had no intro, so readers got no pick between Jinja and Mako.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 06:26:22 +08:00
Vinta Chen
cabd05ec7e
docs: add WebSocket category intro
The page had no intro, so readers got no pick among Channels, Flask-SocketIO, websockets, and Autobahn|Python.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 06:26:18 +08:00
Vinta Chen
10a7f12861
docs: add web servers category intro
The Web Servers page had no intro, so readers got no pick among Gunicorn, Uvicorn, Waitress, Granian, and Hypercorn.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 03:27:35 +08:00
Vinta Chen
d450705926
docs: add web APIs category intro
The Web APIs category page had no intro, leaving readers without a pick among Django REST framework, Django Ninja, FastAPI, and the GraphQL and RPC libraries.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 03:27:23 +08:00
Vinta Chen
3c05cd63d6
docs: add web frameworks category intro
The page had no intro, so readers got no pick among Django, Flask, and the other full-stack and async frameworks.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 03:26:34 +08:00
Vinta Chen
74513330aa
docs: add natural language processing category intro
The page had no intro, so readers got no pick among spaCy, NLTK, Stanza, and the Chinese text libraries.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 03:03:31 +08:00
Vinta Chen
579ea6bf85
docs: add machine learning category intro
The page had no intro, so readers got no pick among scikit-learn, the boosting libraries, pgmpy, Feature-engine, and TimesFM.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 03:03:12 +08:00
Vinta Chen
80958eb516
docs: add deep learning category intro
The Deep Learning page had no intro, leaving readers with no pick among PyTorch, Keras, JAX, Lightning, and the reinforcement learning libraries.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 03:02:51 +08:00
Vinta Chen
4d09bcb7ab
docs: add Implementations category intro
The page had no guidance on when to run CPython vs MicroPython, Pyodide, Cython, or PyPy.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:43:48 +08:00
Vinta Chen
e2308c087d
docs: add Date and Time category intro
The page had no guidance on which Python date library to pick.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:43:45 +08:00
Vinta Chen
432a25e384
docs: add Game Development category intro
The page had no guidance on which Python game library to pick. Recommends pygame-ce over upstream pygame, which fails to install on Python 3.14 (no cp314 wheel, open issues #4627/#4810).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:43:41 +08:00
Vinta Chen
9e8e38eb2e
docs: add web scraping category intro
The web scraping category page had no intro, leaving readers without guidance for picking among crawling frameworks, LLM-ready crawlers, AI browser agents, and content extractors.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:36:14 +08:00
Vinta Chen
fd40096421
docs: add text processing category intro
The page had no intro, so readers got no pick among the encoding detection, fuzzy matching, parser, slug, and ID libraries.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:35:47 +08:00
Vinta Chen
adea5994b9
docs: add file format processing category intro
The category page had no intro, giving readers no guidance for picking among the PDF, Office, Markdown, and config libraries listed.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:35:12 +08:00
Vinta Chen
77b1b70df5
fix: hide use-case and page tags that repeat the group heading
On section and subcategory pages, every row repeated its use case and current page as tags (and as the label under the name on phones), right under a heading that already said the same thing. They are now hidden in editorial order and shown again when a column sort flattens the groups.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:05:18 +08:00
Vinta Chen
ef00fe3adb
fix: restore hidden group headings when navigating to a jump link
After sorting by a column, or while a search hid a group, category page group headings stayed hidden, so the header's jump links (and any use-case heading link) pointed at a hidden element and did nothing.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 02:04:41 +08:00
Vinta Chen
52915911d4
feat: link section use-case headings to their subcategory pages
With tags now pointing at section anchors instead of filtering in place, subcategory pages (74 clicks and 19.7K impressions in the last 3 months) had no other internal links pointing to them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:34:07 +08:00
Vinta Chen
62a4e7c4e5
fix: make tags link to category pages instead of filtering in place
Clicking a category or group tag filtered the homepage table in place while rewriting the address bar to the category URL, so one URL rendered two different pages and readers never reached category pages with their intros and guides; category pages also showed a redundant self-referential filter bar.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:34:07 +08:00
Vinta Chen
e5088a6f5c
docs: rewrite Data Validation category intro
Covers Pydantic for API input and config, Pandera for dataframes, and jsonschema for JSON Schema validation.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:27:34 +08:00
Vinta Chen
c52f21f99d
docs: rewrite CLI Development category intro
Covers argparse for basic apps, Click or Typer beyond that, Rich for output, and TUI frameworks.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:27:29 +08:00
Vinta Chen
ee2874a463
docs: rewrite Testing category intro
Covers pytest as the default, a how-to-choose item per README subcategory, and a guide on Hypothesis, Playwright, tox/Nox, mocks, and coverage.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:27:25 +08:00
Vinta Chen
3c2afa13bb
docs: rewrite Audio & Video Processing category intro
Covers librosa for audio analysis, MoviePy for scripted video editing, VidGear for real-time video, Mutagen vs tinytag for tag read/write and licensing, and beets as a CLI tag/organization tool.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:27:20 +08:00
Vinta Chen
88cfcf6f4d
docs: rewrite Computer Vision category intro
Covers OpenCV as the default, Ultralytics YOLO for detection/segmentation/pose models and its AGPL-3.0/Enterprise License terms, Kornia for GPU-batch vision ops, FiftyOne for dataset curation, and pytesseract vs EasyOCR for OCR.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:27:02 +08:00
Vinta Chen
a9bb827b4a
docs: add Code Analysis category intro
Ruff for linting and formatting, a type checker alongside it, and pre-commit to run them, with per-tool guidance sourced from each project's own docs.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:17:54 +08:00
Vinta Chen
5216fb3c1a
docs: add Image Processing category intro
Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:17:34 +08:00
Vinta Chen
2930319d48
docs: add CMS category intro
Explains when to pick Wagtail (developer-defined page types) versus
django CMS (editors composing pages live), based on each project's
own documentation.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-27 00:16:51 +08:00
Vinta Chen
2b9469c0ae
feat: group category page rows by use case, restructure intro
Category pages sorted rows by downloads, which buried editorial leads (the Django ORM showed as row 7 of 7, tkinter as 14 of 14) against CONTRIBUTING.md's "position is the marker"; the full intro in the hero pushed the table 2.5 screens down on a phone; and every page repeated the same "Search every project in one place" H2.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 23:33:57 +08:00
Vinta Chen
528f9edbb7
fix: expose entry description rows to screen readers
Every entry description row carried aria-hidden="true", hiding descriptions that sighted readers can see from screen readers.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 23:32:20 +08:00
Vinta Chen
9cc721f533
fix: match category meta titles to search query word order
Category page titles read "ORM Python Libraries", but people search "python orm", so the title word order didn't match the query.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 23:28:51 +08:00
Vinta Chen
eb51124608
refactor: extract category table row markup into entry_rows macro
Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 22:20:37 +08:00
Vinta Chen
eaddf9441e
docs: drop links from gui-development how-to-choose list
7 of its 13 items carried links while the other intros' lists carry none, and the entry table already links every project.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 22:14:39 +08:00
Vinta Chen
00915b0300
docs: trim ai-and-agents how-to-choose list to 12 items
The list had 22 items, which in the upcoming layout sits above the entry table and would push it 4-5 phone screens down; it now has one item per README subcategory, in README order, reusing the intro's own wording.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 22:14:15 +08:00
Vinta Chen
2cc1bb440d
docs: rewrite ORM category intro
The old intro told every FastAPI app to use SQLModel, which SQLModel's own docs don't claim beyond simple cases, and leaned on API names from SQLAlchemy's 2.0 rename (Mapped, mapped_column).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 22:09:22 +08:00
Vinta Chen
4d2c9906e3
docs: rewrite GUI Development category intro
The old intro's lead used the same "For a Python X library, use …" template as other category pages, and it carried version-bound usage tips (Qt Widgets vs Qt Quick, pyside6-uic, per-toolkit threading helpers) instead of each project's recommended setup.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 22:09:16 +08:00
Vinta Chen
17bb6270d6
docs: add AI and Agents category intro
The AI and Agents category page had no intro, so readers got a 35-project list with no guidance on which library to pick for building an agent, serving a model, or fine-tuning.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 22:09:10 +08:00
Vinta Chen
1dfa95834d
docs: add GUI Development category intro
Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 20:41:18 +08:00
Vinta Chen
3870b0a723
docs: add Audio & Video Processing category intro
Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 20:40:53 +08:00
Vinta Chen
b71151a808
docs: add Computer Vision category intro
Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 20:40:29 +08:00
Vinta Chen
ec54348e4c
docs: add CLI Development category intro
Covers recommended usage from each project's own docs for Typer, argparse, Click, Rich, and Textual.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 20:10:52 +08:00
Vinta Chen
7d19f84e63
docs: add Data Validation category intro
Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 20:10:14 +08:00
Vinta Chen
fd300c4453
docs: add Testing category intro
Recommends pytest, Hypothesis, Playwright, and tox/nox based on each project's own docs.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 20:09:42 +08:00
Vinta Chen
a74ca52860
feat: render per-category intro text above the entry list
Category pages carried no text of their own beyond the README one-line description, and most meta descriptions fell back to a generic "Explore N curated Python projects" line, which correlated with weak search rankings for category queries. This adds optional per-category intro markdown files rendered under the H1, with the first paragraph used as the meta description and links opening in a new tab, starting with the ORM category.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 19:42:22 +08:00
Vinta Chen
c10264977e
feat: serve redirect stubs for renamed and dissolved category slugs
Renamed or dissolved category slugs (e.g. /categories/web-servers/rpc/, /categories/code-analysis/code-linters/) returned 404, Search Console lists 7 of them, and each audit re-home was dropping the old URL's ranking.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-09-26 18:45:53 +08:00
Vinta Chen
b7313dcffc
test: assert bundled entries have a null PyPI override
The uv-audit bug had no automated guard: pypi_name_overrides.json is
a manual registry, so a wrong-package mapping is only caught if
someone already suspects it.

Two broader checks were measured against the real list and rejected.
Checking that PyPI metadata links back to the entry's GitHub repo
would not have caught uv-audit, since that package declares no
home_page or project_urls, landing it in a 26-entry bucket of
packages that simply don't declare a repo (numba, selenium, pyglet,
etc.), plus 10 benign cases of orgs moving or splitting bindings.
Flagging display-name/repo-name mismatches yields 46 hits, all
legitimate python-X-repo-to-X-package pairs, with uv-build sitting
among them despite being a real Astral package with the identical
shape to uv-audit.

What discriminates is the bundled marker itself: a "(part of X)"
entry ships inside something else and has no package of its own, so
the sweep must never query it. This test walks the real README and
requires a null override for every bundled entry whose normalized
name is PyPI-shaped. Verified it fails with exactly the uv-audit
message when that override is removed, and passes with it restored,
across the three current bundled entries with no false positives. It
runs offline, fitting the existing network-less CI.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-23 01:46:13 +08:00
Vinta Chen
8e7d2bc62c
fix: add null pypi override for uv-audit
Renaming the entry from "uv audit" to "uv-audit" made the name PyPI-shaped: normalize() leaves spaces alone, so "uv audit" failed PYPI_NAME_RE and collect_names skipped it, but "uv-audit" passes, so the next sweep would have queried PyPI for it.

A uv-audit package does exist on PyPI, but it is version 0.1.9 by Alekse Marusich of rocshers, an unrelated third-party tool whose summary ("uv Tool for checking dependencies for vulnerabilities") is close enough to be mistaken for Astral's built-in uv audit subcommand. Without the override the entry would have shown that stranger's download count and lost its Bundled badge.

The sweep now writes uv-audit as NOT_FOUND, which load_downloads skips, so the badge is unaffected.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-23 01:30:53 +08:00
Vinta Chen
0f677911f0
feat: add "Multiple on PyPI" badge for SDK monorepos
azure-sdk-for-python and google-cloud-python were rendering "Not on
PyPI", which is misleading. Both do ship on PyPI, just as many
per-service packages (azure-identity, azure-storage-blob,
google-cloud-storage, etc.) rather than under the repo name.

pypi_name_overrides.json already recorded that distinction in its
reason field; those two entries now carry an optional "badge" value
that build.py reads into the PyPI Downloads column. The other sixteen
no-count entries (cpython, renpy, agent skill repos, etc.) keep
"Not on PyPI" since that remains accurate for them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-23 01:28:33 +08:00
Vinta Chen
733021ae5b
feat: add Bundled badge for entries shipped inside a larger project
django.db.models, geodjango, httpx.URL and uv audit were rendering
"Not on PyPI" alongside eighteen genuinely standalone projects that
simply are not packaged on PyPI, conflating two different reasons for
a missing download count.

These four entries now carry a "(part of X)" description prefix in
README.md, mirroring the existing "(Python standard library)"
convention. build.py reads that prefix into a bundled flag that both
templates render as a "Bundled" badge.

The prefix approach was chosen over a separate data file so README.md
stays the single source of content truth, and over inferring from the
entry name because geodjango is neither dotted nor spaced and would
have been missed. Redundant tail wording was trimmed from the
httpx.URL, geodjango and uv audit descriptions now that the prefix
names the parent.

The new entry format is documented in CONTRIBUTING.md and the
vocabulary in CONTEXT.md.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-23 01:09:20 +08:00