Commit Graph
2812 Commits
Author SHA1 Message Date
Vinta ChenandClaude 9fa72c1ee6 audit: sweep Implementations, drop ironpython
Tiers: cpython, micropython, pypy obvious choices (all no-signal —
distributed outside pip — so alphabetical); cython (130.3M/mo, kept
here by judgment as a Python-superset compiler with no better home)
and pyodide (no pip signal; distributed via CDN and npm) challengers.

Removed:
- ironpython — latest release v3.4.2 (2024-12) still implements
  Python 3.4-era language, a decade behind CPython (verified from the
  release feed; the repo itself is active, so this is not an
  activity-line drop). 2.8K stars. Not an obvious choice for any
  current job.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 13:29:23 +08:00
Vinta ChenandClaude 8a3771e895 feat: add pygame-ce to Game Development > Game Frameworks
Challenger to pygame: the community fork where long-time contributors
now develop, a drop-in replacement (same import name), and community
guidance for new projects favors it — adoption-trajectory evidence
verified by web search. 642.5K downloads/month (pepy), 1.6K stars,
created 2023, pushed 2026-08. Upstream pygame itself has been quiet
since 2025-11. Slots into the open challenger position ahead of
arcade (85.3K/mo).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 13:15:08 +08:00
Vinta ChenandClaude 3f391b34ba audit: sweep Game Development, split into use cases, drop py-sdl2, pyopengl
Restructure: the flat section splits into 3D Engines (panda3d
189.3K/mo, sole obvious choice), Game Frameworks (pygame 3.07M/mo and
pyglet 2.9M/mo obvious choices; arcade 85.3K/mo challenger — pygame-ce
joins as a challenger in its own addition commit), and Visual Novels
(renpy sole obvious choice — its 4/mo pip count is meaningless since
Ren'Py ships as its own SDK; ecosystem verified: 8,000+ published
works, release 8.5.3 in 2026-05).

Removed:
- py-sdl2 — 71.1K downloads/month (as PySDL2), 344 stars; low-level
  SDL bindings whose job pygame-ce and pyglet cover for this list's
  audience. Judgment call.
- pyopengl — 5.3M downloads/month, likely transitive
  scientific-visualization traffic (judgment call, mechanism
  unverified), 415 stars; raw OpenGL bindings are not a
  game-development obvious choice.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 13:14:54 +08:00
Vinta ChenandClaude 8f9c3884bf audit: sweep Audio & Video Processing, re-home TTS to Speech, drop birdnet, matchering
Restructure: gtts and KittenTTS re-home to AI and Agents > Speech — TTS
belongs with the speech models, not audio processing. gtts (3M/mo,
a 2014 service wrapper, quiet since 2026-04) lands as Second Tier;
kittentts (renamed to its canonical PyPI name, 15.3K stars within a
year of creation, pip count 3.9K/mo under-measures model adoption)
as challenger. Speech is now at exact cap (5/5) — future additions
there require displacement.

Audio keeps pydub (21.4M/mo) and librosa (11.7M/mo) as obvious
choices. Video unchanged: moviepy (7M/mo) obvious choice, vidgear
(25.3K/mo) challenger. Metadata reorders to tiers: mutagen (8.2M/mo)
obvious choice; tinytag (5.2M/mo), beets (67.4K/mo, kept as challenger
rather than minting a sole-entry subcategory — judgment call).

Removed:
- birdnet — 7.1K downloads/month, 1.7K stars; an applied bioacoustics
  tool with a genuinely small audience, not an audio-processing
  choice. Judgment call.
- matchering — 16.1K downloads/month, 2.6K stars; a single-task
  automated-mastering tool with a small audience, no trajectory.
  Judgment call.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 13:14:37 +08:00
Vinta ChenandClaude 9970486a2a feat: add rembg to Image Processing > General
Maintainer-requested during the Media audit, replacing dropped
pymatting with the tool whose traffic pymatting was carrying: rembg is
the obvious choice for background removal — 4.1M downloads/month
direct (pepy), 24.3K stars, pushed 2026-08, active release train.
Takes the open third obvious-choice slot in General (no displacement
needed), ordering after pillow and scikit-image.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 13:14:13 +08:00
Vinta ChenandClaude 41a1b4b0ae audit: sweep Image Processing, split into use cases, drop pymatting
Restructure: the flat section splits into Barcodes and QR Codes (qrcode
30.1M/mo, python-barcode 3.4M/mo, both obvious choices — generating
codes is a distinct job from manipulating images), General (pillow
552M/mo, scikit-image 28.5M/mo obvious choices; wand 1.4M/mo, pyvips
808.2K/mo challengers), and Image Serving (thumbor sole obvious choice —
a deployed service, so its 22K/mo pip count under-measures use).

Rename to canonical PyPI name: python-qrcode → qrcode.

Removed:
- pymatting — 3.3M downloads/month, but the traffic is transitive:
  rembg declares pymatting as a hard dependency (verified in rembg's
  PyPI metadata). A single-task alpha-matting library, 1.9K stars,
  quiet since 2026-04; not an obvious choice for image processing.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 13:13:57 +08:00
Vinta ChenandClaude 9bbe1cf6d0 audit: sweep GUI Development, split Desktop into Qt and Tkinter, drop enaml, buridan/ui, curses
Restructure: the 12-entry Desktop use case splits — Qt (PySide6
3.9M/mo, PyQt6 2.7M/mo, co-obvious pair differing in licensing) and
Tkinter (customtkinter 1.13M/mo, tkinter stdlib obvious choices;
tkdesigner challenger, kept by maintainer decision) mint as
subcategories; residual Desktop lands at cap with pygobject (607.6K/mo),
wxPython (354.8K/mo), kivy (288.8K/mo) obvious choices and dearpygui
(193.5K/mo), toga (12.9K/mo, BeeWare trajectory) challengers.

Renames to canonical PyPI names: PyQt → PyQt6, pyside → PySide6 (the
PyPI package named pyside is the dead Qt4-era PySide 1).

Re-homes: urwid (11.3M/mo) moves to CLI Development > TUI Frameworks as
a challenger and pyglet (2.9M/mo, windowing and multimedia for games)
moves to Game Development, dissolving this section's Terminal
subcategory. Web-based keeps pywebview (2.19M/mo), nicegui (1.2M/mo),
flet (444.1K/mo) as obvious choices; gooey stays sole Wrappers entry.

Removed:
- enaml — 14.1K downloads/month, 1.6K stars after 13 years; a
  declarative Qt DSL nobody names unprompted. Judgment call.
- buridan/ui — 248 stars, no PyPI package; a component-snippet
  collection for Reflex, not a GUI framework. Fails admission.
- curses — standard-library rule: stdlib holds a slot only where it is
  itself the obvious choice, and for building TUIs that is textual.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:56:44 +08:00
Vinta ChenandClaude 1a8e14c177 audit: sweep CLI Tools, dissolve Productivity Tools, drop thefuck, kaydet, doitlive
Restructure: the Productivity Tools grab-bag dissolves into use cases —
Project Scaffolding (cookiecutter 10.1M/mo obvious choice, copier
2.5M/mo challenger), Shells (xonsh 419.5K/mo), Downloaders (yt-dlp
17.7M/mo), Terminal Workflow (tmuxp 129.4K/mo). CLI Enhancements
renames to Database CLIs (pgcli 636.6K/mo, mycli 124.9K/mo, litecli
74.2K/mo obvious choices; iredis 8.3K/mo challenger); HTTP Clients
minted for httpie.

httpie kept by explicit maintainer override of the 12-month activity
line (repo dormant since 2024-12, last release 2024-11; 1.04M
downloads/month) — second use of the schedule precedent.

Removed:
- thefuck — dormant since 2024-07, past the 12-month activity line;
  7K downloads/month (most installs come from brew, not pip).
- kaydet — 48 stars, 5.6K downloads/month; a personal diary tool
  nowhere near obvious-choice or challenger territory.
- doitlive — 651 downloads/month against 3.6K stars; alive but
  effectively unused. Judgment call.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:56:03 +08:00
Vinta ChenandClaude 35c68984e8 audit: sweep CLI Development, mint TUI Frameworks, drop cement
Restructure: textual and asciimatics move from Terminal Rendering to a
minted TUI Frameworks subcategory — full-screen terminal UIs are a
distinct job from rendering output. urwid joins them in the GUI
Development commit, which dissolves that section's Terminal subcategory.

Renames to canonical PyPI names: python-prompt-toolkit → prompt_toolkit,
python-fire → fire (the PyPI package named python-fire is an unrelated
name-squatter; Google's project installs as fire).

Tiers: click (1.12B/mo), typer (366M/mo), argparse (stdlib) obvious
choices; prompt_toolkit (246.8M/mo), fire (22M/mo) challengers.
tqdm (670.1M/mo), rich (626.7M/mo) obvious choices; colorama
(425.6M/mo, largely pip-transitive traffic, superseded by rich for new
code) demoted to challenger (Second Tier) beside alive-progress (3.7M/mo).
textual (535.4M/mo) obvious choice of TUI Frameworks, asciimatics
(177.5K/mo) challenger.

Removed:
- cement — 565K downloads/month but 1.3K stars after 17 years
  (CI-shaped count); alive yet no longer anyone's unprompted answer
  against click, typer, fire, or prompt_toolkit. Judgment call.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:55:38 +08:00
Vinta ChenandClaude 3290ce586a style: merge Security Linters into Linters and Formatters
bandit (29.5M downloads/month) sorts last in the second tier behind pylint 65.2M and flake8 56.7M. The merged use case now holds 6 entries, past the hard cap of 5, by explicit maintainer override -- the list's first cap override, accepted knowingly.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:26:20 +08:00
Vinta ChenandClaude b8cacb558c audit: sweep Network Virtualization to the shortlist cap
Removed mininet: no commits since 2024-07, past the 12-month activity
line; 2026 sources describe it as fading with forks carrying
development; its 3.7K/month PyPI row is not its real distribution
channel.

Reordered remaining obvious choices by downloads: scapy 4.4M then
napalm 199K.

Section rename to Networking was offered and the maintainer left the
current name standing.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:19:44 +08:00
Vinta ChenandClaude 635a735802 audit: sweep Logging to the shortlist cap
Removed logfmter (197,351 downloads/month, 107 stars) — logfmt formatting is a small audience and it is not a credible successor to any obvious choice; judgment call.

Reordered by tier and downloads: obvious choices structlog 114.5M (2026 consensus production pick), loguru 82.5M (developer-experience pick), and stdlib logging last as a no-signal entry — kept because stdlib logging is itself the obvious choice for the use case, the stdlib rule's yes-case.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:19:12 +08:00
Vinta ChenandClaude 03d9139c35 audit: sweep Job Schedulers to the shortlist cap
Split the flat section into two use cases — Task Scheduling (in-process scheduling) and Workflow Orchestration (data-pipeline orchestrators) — six entries were covering two distinct jobs.

Removed SpiffWorkflow (59,736 downloads/month — BPMN engine, a different job than scheduling or orchestration, small audience; active repo, drop is a judgment call).

Kept schedule by explicit maintainer override (9.4M downloads/month, 12.3K stars, but no commits since 2024-05 — past the 12-month activity line; the maintainer overrode the activity rule, schedule slots as challenger behind apscheduler).

Renamed airflow to apache-airflow (PyPI name — the bare airflow package is a 38K/month shim).

Ordering: Task Scheduling apscheduler 55.5M obvious choice then schedule 9.4M challenger; Workflow Orchestration obvious choices apache-airflow 20.9M, prefect 14.0M, dagster 10.2M.

luigi's removal from Distributed Computing rode that section's commit; flytekit was proposed and declined.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:18:40 +08:00
Vinta ChenandClaude 7fd495730d feat: add paho-mqtt to Messaging
Obvious choice per DevOps audit adjudicated by maintainer 2026-08-16: 9.1M downloads/month via ClickPy, Eclipse Foundation client described by 2026 sources as the bedrock of MQTT in Python. Ordered after pika (13.7M/month), before challenger faststream (1.5M/month).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:17:59 +08:00
Vinta ChenandClaude 28b6d1398b feat: add pika to Messaging
DevOps audit adjudicated by maintainer 2026-08-16: pika is the standard RabbitMQ/AMQP 0-9-1 client, 13.7M downloads/month via ClickPy. Ordered after confluent-kafka (61.8M/month) per downloads-descending tier.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:17:28 +08:00
Vinta ChenandClaude e5ce98c0f2 feat: add confluent-kafka to Messaging
DevOps audit adjudicated by maintainer 2026-08-16: 61.8M downloads/month via ClickPy, librdkafka-backed, 2026 sources call it the production Kafka default. kafka-python is unmaintained and was excluded. Placed first per downloads-descending obvious-choice tier; pika and paho-mqtt follow in subsequent commits.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:16:59 +08:00
Vinta ChenandClaude 83c723d61f style: reorder Task Queues by tier and downloads
DevOps audit adjudicated 2026-08-16, format-only (no removals).
Obvious choices: celery 58.4M, rq 18.1M, dramatiq 1.6M (promoted --
2026 sources call it the top celery alternative with closest feature
parity). Challengers: huey 20.9M (demoted -- raw count highest but
2026 sources file it as the lightweight small-app option), taskiq
2.0M. flower sub-item rides celery.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:16:27 +08:00
Vinta ChenandClaude 4fc32225a9 audit: sweep Distributed Computing to the shortlist cap
Removed luigi (1,546,263 downloads/month, repo active with a push 2026-07) — the drop is editorial: Spotify itself moved to Flyte, 2026 orchestration comparisons no longer name luigi, and the Workflow Orchestration slots in Job Schedulers go to airflow, prefect, dagster.

Flattened the sole Batch Processing subcategory — the label added nothing, the section is a single use case.

Reordered by tier and downloads: obvious choices ray 62.6M, pyspark 48.3M, dask 30.0M; challengers joblib 216.9M raw (scikit-learn-dependency-inflated, judgment call — raw count still sorts it first in tier) and mpi4py 1.0M (HPC standard, specific audience not small).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:15:51 +08:00
Vinta ChenandClaude 77e7b62d93 feat: add google-cloud-python to Cloud Providers
DevOps audit adjudicated by maintainer 2026-08-16: obvious-choice umbrella repo published as per-service packages, so no single download figure applies (google-cloud-storage alone is 253.1M downloads/month). Repo-name entry per the naming rule, placed after azure-sdk-for-python per no-signal alphabetical ordering within tier.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:15:10 +08:00
Vinta ChenandClaude b06104c97e feat: add azure-sdk-for-python to Cloud Providers
DevOps audit adjudicated by maintainer 2026-08-16: obvious choice. Umbrella repo published as per-service packages, so no single download figure exists; azure-identity alone is 230.4M downloads/month. Repo-name entry used per the naming rule since there is no single pip name.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:14:32 +08:00
Vinta ChenandClaude a610fcec61 audit: sweep DevOps Tools to the shortlist cap
removed openstack (mirror-index repo aggregating OpenStack projects — nothing installable, not configuration management; its daily pushes are mirror automation)
removed kubesdk (2,135 downloads/month, 105 stars, repo created 2025-10, entered via PR #3166 — nowhere near obvious choice or challenger; maintainer also declined adding the official docker and kubernetes clients, so no Containers use case)
renamed cloudinit to cloud-init (repo name; not on PyPI), saltstack to salt (PyPI name; Broadcom-sponsored, kept as Second Tier challenger — PyPI 102K/month undercounts onedir and distro installs), sentry-python to sentry-sdk (PyPI name; 178.5M/month), borg to borgbackup (PyPI name; the bare borg package on PyPI is unrelated)
reordered every subcategory by tier and downloads: Cloud Providers boto3 3.4B then awscli 264.3M; Configuration Management ansible 13.0M and no-signal cloud-init obvious choices, pyinfra 271K and salt challengers; Deployment fabric 12.7M then chalice 930K; Monitoring and Processes psutil 391.5M, sentry-sdk, supervisor 16.8M, challenger sh 12.0M; Other pre-commit 198.0M, borgbackup 76K, chaostoolkit 18K

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 12:13:54 +08:00
Vinta ChenandClaude fb7383cd9b docs: point Build Tools readers to Package Management
uv-build was deliberately not admitted to Build Tools since PEP 517 backends are a different job; that structure decision is deferred to the Python Toolchain sitting. Add a cross-reference so readers looking for Python packaging/build tooling (uv build backend, hatch) land on Package Management instead.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:58:58 +08:00
Vinta ChenandClaude 166c9c97df style: reorder Algorithms and Design Patterns and Documentation by downloads
Developer Tools audit adjudicated by maintainer 2026-08-16, format-only outcome for the two sections with no removals.

Algorithms: sortedcontainers (278.7M/month) first, then educational no-signal repos algorithms and thealgorithms alphabetically.
Design Patterns: transitions (2.9M/month) before no-signal python-patterns.
Documentation: sphinx (85.9M), mkdocs (17.8M), diagrams (6.8M) as obvious choices, pdoc (2.1M) as challenger.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:57:52 +08:00
Vinta ChenandClaude 2d0f5da279 feat: add mkdocs-material as sub-item under mkdocs
Adjudicated by maintainer 2026-08-16: mkdocs-material pulls 17.6M downloads/month via ClickPy, nearly equal to mkdocs itself, and is the theme most mkdocs sites run. Listed as a sub-item since its job is inseparable from its parent.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:57:11 +08:00
Vinta ChenandClaude 71eee5d240 feat: add ipython to Interactive Interpreter
Obvious choice per maintainer audit 2026-08-16: 175.7M downloads/month
via ClickPy, the default enhanced REPL and the kernel under Jupyter,
yet missing from the README. Placed first per downloads-descending
obvious-choice tier (jupyter 17.5M follows).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:56:39 +08:00
Vinta ChenandClaude 8125688493 audit: sweep Build Tools to the shortlist cap
Removed bitbake (no PyPI distribution, ships with Yocto — its users are embedded-Linux developers, fails the Serves Python Developers scope test). Removed platformio (1,255,169 downloads/month — embedded and IoT toolchain written in Python but used for C and C++ firmware work, same scope test as bitbake). Removed pybuilder (51,511 downloads/month — searches confirm niche adoption, small community, fails the obvious-choice bar). Reordered remaining entries: invoke (85.4M) and scons (924K) as obvious choices, doit (803K) as challenger.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:56:08 +08:00
Vinta ChenandClaude d316a8ee2a feat: add pyinstrument to Profiler
Developer Tools audit adjudicated by maintainer 2026-08-16: obvious choice per ClickPy (10.6M downloads/month), a statistical wall-clock profiler and common first reach for request-level profiling. Ordered after memray (15.6M/month), before challenger scalene (400K/month).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:55:29 +08:00
Vinta ChenandClaude 3a65a020c4 feat: add memray to Profiler
Bloomberg memory profiler that tracks allocations in Python code, native extensions, and the interpreter itself. 15.6M downloads/month via ClickPy; the obvious choice for memory profiling work per maintainer audit 2026-08-16. Ordered after py-spy (28.5M/month) per downloads-descending tier.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:54:56 +08:00
Vinta ChenandClaude b4960530ad audit: sweep Debugging Tools to the shortlist cap
Developer Tools audit adjudicated by maintainer 2026-08-16:
- removed manhole (1,060,111 downloads/month but last push 2024-07, past the 12-month activity line; also mis-homed under Tracing, it is an inspection socket not a tracer)
- removed memory_graph (13,393 downloads/month, added 2025-12 by the project's own author with no displacement argued, teaching aid, fails the obvious-choice bar)
- renamed python-hunter to hunter (PyPI package name is hunter; the python-hunter name on PyPI is a squatter)
- reordered Others by downloads: django-debug-toolbar 9.1M, icecream 1.95M, flask-debugtoolbar 1.24M

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:54:10 +08:00
Vinta ChenandClaude 5e3d77826a feat: add pyright to Type Checkers
Adjudicated by maintainer 2026-08-16: obvious choice (39.4M downloads/month via ClickPy; 2026 sources call it the strong default -- conformance lead, Pylance engine, editor integration). Ordered after ty (41.2M/month) per downloads-descending obvious-choice tier.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:53:30 +08:00
Vinta ChenandClaude 3e90482f01 audit: sweep Code Analysis to the shortlist cap
Removed code2flow (36,486 downloads/month, last push 2025-07 — fails the obvious-choice bar, same test as dropped peers).
Removed pytype (919,951 downloads/month — Google sunset, maintenance mode, Python 3.12 is the last supported version).
Merged Code Linters + Code Formatters into one Linters and Formatters use case (ruff is the 2026 de facto standard for both; tiers: ruff/black/isort obvious choices, pylint/flake8 second tier).
Re-homed bandit to new Security Linters subcategory (security linting is a distinct job from style linting).
Demoted typeshed to sub-item under mypy (stub infrastructure every checker consumes, not itself a checker holding a slot).
Promoted ty to obvious choice (maintainer call), order mypy/ty then pyrefly challenger.
Reordered Code Analysis subcategory vulture first (12.3M/month obvious choice, prospector 485K and repowise 33K challengers — repowise kept on maintainer flip).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 11:52:55 +08:00
Vinta ChenandClaude 8814a85742 feat: store verdict preview pages in repo-local ./tmp
Multi-day reviews need to survive reboots, which system /tmp does not
guarantee. ./tmp is git-ignored so the generated pages never land in
commits.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 03:21:04 +08:00
Vinta ChenandClaude a2da210345 feat: stamp pypi downloads cache with fetched_at and header row
Adds a header row (name, downloads, fetched_at) to data/pypi_downloads.tsv
and stamps every row with the sweep date, so audits can tell evidence age
and skip re-fetching when the cache is less than 7 days old. The sweep
itself costs ~1s, so freshness is checked by the reader (audit-the-list
skill) instead of skip logic in the fetch script. SKILL.md documents the
7-day freshness rule.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:58:20 +08:00
Vinta Chen 36c61798c4 update wordings 2026-08-16 02:53:24 +08:00
Vinta ChenandClaude c6957d4c21 docs: require WebSearch evidence for tier judgments
Verifying keep/drop reasons with download counts alone isn't enough to judge obvious-choice vs challenger tiers; the maintainer requires WebSearch evidence of adoption trajectory and community sentiment too. Also rewrites the repo overview in CLAUDE.md and mirrors it to AGENTS.md per the kept-in-sync convention.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:52:03 +08:00
Vinta ChenandClaude 6c93b1e588 docs: update audit-the-list SKILL.md wording
Broaden argument-hint to cover thematic groups alongside sections,
and backtick tool/skill names for consistency.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:45:34 +08:00
Vinta ChenandClaude bc3e7a08cd docs: condense AGENTS.md and CLAUDE.md for progressive disclosure
Trim repository overview and structure sections into a brief intro
plus focused Entry Rules and Gotchas sections, dropping restated
CONTRIBUTING.md content and Makefile/pyproject boilerplate.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:45:31 +08:00
Vinta ChenandClaude 5da1d16de1 docs: define Second Tier in CONTEXT.md
The 2026-08-16 Database & Storage audit exposed a vocabulary gap: four adjudicated entries (clickhouse-driver, dogpile.cache, django-cacheops, django-haystack) are neither Obvious Choices nor trajectory-backed Challengers but demoted incumbents occupying Challenger slots, and the sitting had to improvise the term. The maintainer ratified it during review. A demoted incumbent counts against the two Challenger slots, but the adoption-trajectory bar gates only new admissions, not demotions.

Also from the same sitting: psycopg2 was deliberately left unlisted under Database Drivers > PostgreSQL (282M downloads/month as psycopg2-binary, pepy 2026-08-16) because psycopg 3 is the new-work answer and v2 is legacy install base. Recorded here so the next PostgreSQL audit knows it was a decision, not an oversight.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:40:44 +08:00
Vinta ChenandClaude 745347dcdd style: reorder Serialization by downloads
Audit outcome of the Database & Storage sitting, maintainer adjudicated
2026-08-16, format-only.

Reordered from alphabetical to the entry-ordering rule: obvious choices by downloads/month descending, then challenger.
msgpack 290,175,972; orjson 234,189,977; marshmallow 122,497,803; msgspec (challenger) 43,745,974.
PyPI last-30-day downloads via ClickPy, fetched 2026-08-16.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:39:48 +08:00
Vinta ChenandClaude 509fcaa384 feat: add meilisearch to Search as a challenger
Official Python client for the Meilisearch engine, 1,107,508 downloads/month (pepy.tech, fetched 2026-08-16). Admitted on the engine's developer-tool adoption trajectory; flagged as the weakest add of the Database & Storage audit (maintainer adjudicated 2026-08-16) and a judgment call in the reviewed verdicts. Placed after the obvious choices (elasticsearch, opensearch-py), before second-tier django-haystack, per entry-ordering rule.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:34:08 +08:00
Vinta ChenandClaude f953956703 feat: add opensearch-py to Search as obvious choice
Database & Storage audit (2026-08-16): opensearch-py is the official
low-level client of the OpenSearch fork, 52,432,831 downloads/month,
near parity with elasticsearch at 54,160,230/month (both pepy.tech,
fetched 2026-08-16). Placed after elasticsearch, before second-tier
django-haystack, per entry-ordering rule.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:33:25 +08:00
Vinta ChenandClaude 7ac2950dc6 audit: sweep Search to the shortlist cap
Removed pysolr (352,069 downloads/month via ClickPy, 347,571 pepy same-source, fetched 2026-08-16) — lightweight Apache Solr wrapper, the Solr era passed.

Renamed elasticsearch-py to elasticsearch per the PyPI-package-name naming rule in CONTRIBUTING.md; also fixes a NOT_FOUND row in every downloads sweep.

Reordered: elasticsearch (54,160,230/month pepy) obvious choice first, django-haystack (194,205/month pepy) kept and moved to second tier per maintainer's tier call during verdict review.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:32:47 +08:00
Vinta ChenandClaude 02735b6ced style: reorder Caching by downloads, rename python-diskcache to diskcache
Caching section audit (maintainer adjudicated 2026-08-16, format-only):

- Renamed python-diskcache to diskcache to match its PyPI package name per CONTRIBUTING.md naming rule; also fixes a NOT_FOUND row in every downloads sweep.
- Reordered by monthly downloads (pepy): cachetools (338,290,732) and diskcache (38,755,627) as obvious choices, then dogpile.cache (2,460,237) and django-cacheops (1,728,494) as second-tier challengers.
- Maintainer confirmed keeping diskcache despite the repo being dormant since 2024-08: 38.8M downloads/month and nothing succeeds it at its job.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:32:02 +08:00
Vinta ChenandClaude b7b633d509 feat: add lancedb to Database & Storage > Vector
Adds lancedb as obvious choice #2 in Vector, from the Database & Storage audit (maintainer adjudicated 2026-08-16): embedded vector database for multimodal AI, 9,315,269 downloads/month (pepy.tech, fetched 2026-08-16), 11.2K stars, very active (pushed 2026-08-15). Same-source check keeps chromadb first (13.3M pepy); zvec stays last as trajectory challenger.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:31:17 +08:00
Vinta ChenandClaude 3a3b20c03d audit: sweep Database to the shortlist cap
Split the flat Database section into three subcategories (Analytical,
Vector, Key-Value & Document) since its 7 entries exceeded the shortlist
cap of 5 and the size reflected genuinely distinct jobs:

- Analytical: duckdb (obvious choice, 61,026,806 downloads/month), chdb
  (challenger, 3,564,786 downloads/month)
- Vector: chromadb (obvious choice, 13,048,822 downloads/month), zvec
  (challenger on star trajectory, 44,737 downloads/month, 15.4K stars
  in 8 months)
- Key-Value & Document: tinydb (obvious choice, 6,194,854 downloads/month)

Removed:
- pickledb (29,446 downloads/month) - toy key-value store
- ZODB (197,044 downloads/month) - Zope-era native object database
  nobody names unprompted in 2026; repo still active, this is a
  relevance call, not an abandonment call

Rewrote the section description from "Databases implemented in
Python" to "In-process databases usable directly from Python"
because duckdb, chdb, and zvec are not themselves implemented in
Python, and the written-in-Python scope test was already removed
from CONTRIBUTING.md.

Downloads are PyPI last-30-day via ClickPy, fetched 2026-08-16.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:30:29 +08:00
Vinta ChenandClaude 442291d74a feat: add oracledb to Database Drivers > Other Relational Databases
Oracle's official driver, successor to cx_Oracle. 26,856,874 downloads/month (pepy.tech, fetched 2026-08-16), from the Database & Storage audit (maintainer adjudicated 2026-08-16). Placed as obvious choice #2 between pyodbc (42.9M) and challenger mssql-python (3.3M) per entry-ordering rule.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:29:30 +08:00
Vinta ChenandClaude 9b28c566bf feat: add pyodbc to Other Relational Databases
SQL Server / ODBC standard for two decades, 42,911,527 downloads/month (pepy.tech, fetched 2026-08-16). Its absence was a gap in the list from the Database & Storage audit, not a verdict on the project. Listed as obvious choice #1, before mssql-python (3.3M/month challenger), per entry-ordering rule.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:28:45 +08:00
Vinta ChenandClaude 774da7236e feat: add clickhouse-connect to Database Drivers > ClickHouse
Database & Storage audit (2026-08-16): official ClickHouse client at 31,797,323 downloads/month has overtaken community clickhouse-driver at 18,405,937/month (pepy.tech, same source, fetched 2026-08-16). Listed first per entry-ordering rule; clickhouse-driver stays second tier.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:28:05 +08:00
Vinta ChenandClaude 0cc4e0eed4 feat: add asyncpg to Database Drivers > PostgreSQL
MagicStack's asyncio PostgreSQL driver, 122,401,686 downloads/month
(pepy.tech, fetched 2026-08-16). Verified as obvious choice #2 behind
psycopg (130.8M downloads/month, same source) in the Database & Storage
audit; last push 2026-02, inside the 12-month Active rule. Its absence
was a gap in the list.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:27:18 +08:00
Vinta ChenandClaude b8dd6538c2 style: restructure Database Drivers section
Database & Storage audit (maintainer adjudicated 2026-08-16), format-only outcome, no removals:

- Mint a ClickHouse subcategory between SQLite and Other Relational Databases, moving clickhouse-driver into it; two ClickHouse clients justify their own use case (official clickhouse-connect lands next as its own add commit).
- Rename entry redis-py to redis per the PyPI-package-name naming rule in CONTRIBUTING.md; also fixes a NOT_FOUND row in every downloads sweep.
- Reorder MySQL (pymysql 96.4M downloads/month before mysqlclient 20.4M) and NoSQL Databases (redis 277M pepy, pymongo 116.6M, cassandra-driver 8.0M, then django-mongodb-backend 31K as challenger) per the entry-ordering rule.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:26:28 +08:00