Skip to content

Render candidates README from Reservoir manifest - #15

Merged
justincasher merged 2 commits into
mainfrom
justin/candidates-readme-renderer
May 9, 2026
Merged

justincasher merged 2 commits into
mainfrom
justin/candidates-readme-renderer

Conversation

@justincasher

@justincasher justincasher commented May 9, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • New lean_pool.aggregator.render module with render_table(manifest) and update_readme(path, table). The renderer replaces the content between the existing <!-- BEGIN/END AUTOGENERATED TABLE --> markers, so anything you write outside the markers in the candidates README is preserved.
  • CLI restructured as a click group with two subcommands:
    • python -m lean_pool.aggregator fetch — download the manifest (existing behavior).
    • python -m lean_pool.aggregator render — regenerate the README table.
  • Populates aggregator/candidates/README.md with all 617 packages currently in Reservoir, sorted by stars descending with alphabetical tiebreak.
  • Removes aggregator/candidates/packages/.gitkeep. Per the discussion that led here, we are not storing per-package metadata files; when we start making inclusion decisions we will add a single decisions.jsonl instead.

Table columns

Stars | Package (linked) | Description (truncated to 120 chars, pipes escaped) | License | Latest version | Build (✓ / ✗ / –)

Adds aggregator.render with render_table(manifest) and update_readme()
that replace the content between BEGIN/END AUTOGENERATED markers.
Restructures the aggregator CLI as a click group with two subcommands:
fetch (existing behavior) and render (new). Default paths point at
aggregator/candidates/raw_data/manifest.json and the candidates README.

Renders all 617 packages currently in Reservoir into the README sorted
by stars descending with ties broken alphabetically. The packages/
subfolder and its .gitkeep are removed; inclusion decisions will be
tracked in a separate decisions.jsonl when we start making them, not
in per-package metadata files.
@justincasher
justincasher requested a review from Vilin97 as a code owner May 9, 2026 19:23
Reservoir's per-package version field is "0.0.0" for ~90% of packages
because most have no git tag, so the column was largely uninformative.
Switch to the package's updatedAt timestamp (formatted YYYY-MM-DD),
which is meaningful for every package and surfaces which ones are
actively maintained.
@justincasher
justincasher merged commit 5fbf82d into main May 9, 2026
2 checks passed
@Vilin97
Vilin97 deleted the justin/candidates-readme-renderer branch May 9, 2026 21:57
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.

1 participant