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.
| 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 |