toolroom.refresh¶
Observe what is new on this platform, and fold it into the store.
gather then assemble, in one process — the whole job when one
machine is the whole matrix, and exactly the two halves the weekly
workflow runs on three machines and one assembler. There is no third
code path: what runs locally is what runs in CI, with the document
handed across a function call instead of an artifact.
Nothing new anywhere means nothing to release, and that is the whole exit condition. An index that would not answer is reported and exits non-zero rather than counting as "nothing new": a rename or a moved repo would otherwise make a tool silently untracked while the job kept reporting success.
With --submit, a refresh that moved a tool's surface is
committed on the day's branch and submitted as a pull request:
armed when every change only added to a surface, the graded
trigger's green light, and left for a person otherwise. A day's
branch that origin already holds with every file this refresh
wrote means the day's refresh is already submitted. Nothing moved
means no branch and no pull request. A refresh asked to submit
submits from the history of origin's default branch alone, so on
another checkout, a branch a rehearsal runs on among them, it
observes nothing and says so.
| Parameter | Type | Default | Description |
|---|---|---|---|
--only=VALUE |
"" |
refresh just this tool | |
--prefix=VALUE |
"" |
drive the tiers from this prefix's bin/ | |
--changelog |
flag | true |
write the events into CHANGELOG.md |
--submit |
flag | false |
commit what moved on a branch and open its pull request |
Returns: Refreshed {read, events, unreachable, skipped, holes, wrote_changelog, release, additions_only, ingest, ingest_ok, artifacts}
| Field | Type |
|---|---|
read |
a mapping of lists of text |
events |
a mapping of lists of text |
unreachable |
a mapping of text |
skipped |
a list of text |
holes |
a mapping of lists of text |
wrote_changelog |
true/false |
release |
true/false |
additions_only |
true/false |
ingest |
a mapping of lists of text |
ingest_ok |
true/false |
artifacts |
a mapping of lists of text |