toolroom.read¶
Read the tools installed on this machine into their records.
A reading is a snapshot: what one tool accepted at one version, on
one machine. Point --prefix at a fm toolroom.provision directory to
take that snapshot from the isolated latest set instead of whatever
this machine has — a dev environment's pytest carries its plugins'
flags too, and those do not belong in a record whose driver never
asked for them.
A tool that isn't installed keeps the record that is checked in — there is nothing to read it from, and a record that exists beats one that was emptied because a laptop happened to be missing a binary.
| Parameter | Type | Default | Description |
|---|---|---|---|
--only=VALUE |
"" |
regenerate just this tool | |
--prefix=VALUE |
"" |
read binaries from this prefix's bin/ |