Skip to content

toolroom.gather

Observe every release this platform has not yet accounted for.

Half of a refresh, and the half that must happen on the platform: a Linux box cannot tell you what a tool's --help says on Windows. It writes no store — only a document saying what this machine saw — so the three platforms of a matrix can run at once and nothing races for the files.

What it observes: every release newer than each tool's base, every hole the chain reports, and the base itself when this platform has not looked at it yet — that last one is what makes a new platform's coverage converge on the versions people are actually running, in one pass. --count also reaches below the floor, for deepening a platform's history the way prime does.

--out writes the document for another machine to fold; without it the document is returned (and printed under --json), which is what refresh uses when both halves run in one process.

fm toolroom.gather [--only=VALUE] [--prefix=VALUE] [--out=VALUE] [--count=INT]
Parameter Type Default Description
--only=VALUE "" gather just this tool
--prefix=VALUE "" drive the tiers from this prefix's bin/
--out=VALUE "" write the observation document here
--count=INT int 0 also reach this many releases below the floor

Returns: Gathered {platform, observations, holes, unreachable, skipped}

Field Type
platform text
observations a mapping of a mapping of an object
holes a mapping of lists of text
unreachable a mapping of text
skipped a list of text

Example

$ fm toolroom.gather