Skip to content

feat: crates.io column — 43rd column type, Rust package registry trifecta with npm + pypi - #38

Merged
aaronjmars merged 1 commit into
mainfrom
feat/cratesio-column
May 14, 2026
Merged

aaronjmars merged 1 commit into
mainfrom
feat/cratesio-column

Conversation

@aaronjmars

Copy link
Copy Markdown
Collaborator

What

Adds crates.io as the 42nd column type — the Rust package registry, paired with npm (PR #35, May-12) and PyPI (PR #36, May-13, still open) to complete the registry triple shipped this week. Together npm + PyPI + crates.io bracket the three registries the AI/ML, web, and systems-programming crowds actually live in.

Five sort axes via the documented ?sort= parameter:

  • Trending (90d downloads) — recent-downloads, the column default. Matches what crates.io's homepage surfaces as "Just Updated."
  • All-time downloads — downloads, the cumulative giants (tokio, serde, syn, etc.).
  • Recently updated — recent-updates, what's actively maintained.
  • Newest — new, what just got published.
  • A–Z — alpha, deterministic for fixtures.

Optional q= search across crate name, description, and keywords.

Why

After npm (May-12, PR #35) and PyPI (May-13, PR #36 — open), Rust was the last major package registry without a minitor surface. Rust's audience overlaps heavily with minitor's existing TypeScript + Python user base — the same operators running a langchain PyPI column also want to see tokio, axum, or polars-rs activity. The crates.io API is fully keyless and well-documented, matching minitor's no-secrets-required design philosophy. This is the natural follow-on the May-13 PyPI PR description explicitly framed as the next gap: "together npm + pypi bracket the two registries the AI/ML research crowd lives in." crates.io closes the gap for the third major language registry.

Changes

  • `lib/integrations/crates.ts` — keyless `GET /api/v1/crates` fetcher with five sort axes, optional q= search, User-Agent compliance (required by crates.io's documented policy — anonymous requests without UA get 403). Pagination via `meta.next_page` with length-fallback for older mirror deployments that omit the field. Schema-drift safe (drops rows missing name or version).
  • `lib/columns/plugins/crates/` — standard 3-file plugin (plugin.ts / server.ts / client.tsx). #DEA584 Rust ember orange accent (distinct from npm #CB3837 red, pypi #3776AB blue, devto #3b49df indigo, github-actions #2088FF blue, lobsters #ac130d red). `Box` icon visually evokes a crate, distinct from npm's `Package` and pypi's `Package2`.
  • `lib/columns/plugins/manifest.ts` + `lib/columns/registry.ts` + `lib/columns/server-registry.ts` — 3 registry edits, parity check passes.
  • `README.md` — hero paragraph picks up crates.io, column count 41 → 42, News & web cluster row 8 → 9 (`bing, google-news, news-search, rss, lobsters, stack-overflow, devto, npm, crates`), keyless-columns list updated.

How it works

Three integration quirks worth flagging in case future maintainers hit them:

  1. User-Agent is non-optional. crates.io's documented policy is that every anonymous request must set a User-Agent header — they return 403 otherwise. The integration sets `minitor/1.0 (+https://github.com/aaronjmars/minitor)\` on every call.
  2. `recent_downloads` is 90-day, not 30-day or 7-day. Unlike npm's last-week stats endpoint, crates.io's recent metric is a fixed 90-day window. The UI label reflects this ("/90d"), so users know they're looking at quarterly volume, not weekly.
  3. `max_stable_version` fallback chain. A crate's displayed version walks `max_stable_version → max_version → newest_version` — pre-release-only crates would otherwise show no version. This matches what crates.io's own UI does.

The row renders: crate slug (mono font, hover-coloured), description (3-line clamp), brand pill with version + relative time, recent-90d + all-time download badges using `formatCompactCount` for K/M/B formatting, and up to 5 keyword pills.

Test plan

  • After merge: create a `crates` column with default config (no query, sort: Trending) → top trending crates load
  • Switch sort to "Recently updated" → row order changes, relative-time pills update accordingly
  • Set query "tokio" → results filter to tokio-adjacent crates, exact_match pinned where applicable
  • Set query "async-trait" (a popular scoped crate) → renders without 403, downloads count present
  • Sort "Newest" → recently created crates appear, no NaN downloads
  • Pagination → "Load more" fetches page 2 without dropping rows

Built autonomously by Aeon

Natural completion of the registry triple shipped this week (npm May-12,
pypi May-13, crates.io May-14). Together npm + pypi + crates.io bracket
the three registries the AI/ML, web, and systems-programming crowds
actually live in.

- lib/integrations/crates.ts: keyless GET /api/v1/crates fetcher. Five
  sort axes — recent-downloads (90d trending, default), downloads (all-
  time), recent-updates, new, alpha. Optional q= search across name +
  description + keywords. Required User-Agent header per crates.io
  documented policy (anonymous requests without UA get 403). Pagination
  via meta.next_page with length-fallback for older mirror deployments.
- lib/columns/plugins/crates/: standard 3-file plugin. #DEA584 Rust ember
  orange accent (distinct from npm #CB3837 red, pypi #3776AB blue), Box
  icon (visually evokes a crate, distinct from npm's Package and pypi's
  Package2). Row shows: crate slug, description, version, recent-90d
  + all-time download badges, keyword pills, relative time.
- 3 registry edits (manifest.ts, registry.ts, server-registry.ts).
- README: News & web cluster 8 → 9 (with crates), column count 41 → 42,
  hero paragraph + keyless list pick up crates.io.
@aaronjmars
aaronjmars force-pushed the feat/cratesio-column branch from 12ee6a1 to 93a18eb Compare May 14, 2026 12:44
@aaronjmars
aaronjmars merged commit 2d3b4e2 into main May 14, 2026
1 check passed
@aaronjmars
aaronjmars deleted the feat/cratesio-column branch May 14, 2026 12:44
@aaronjmars aaronjmars changed the title feat: crates.io column — 42nd column type, Rust package registry trifecta with npm + pypi feat: crates.io column — 43rd column type, Rust package registry trifecta with npm + pypi May 14, 2026
aaronjmars added a commit that referenced this pull request May 14, 2026
…name

fix: rename #38 squash commit to '43rd column type'
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants