Skip to content

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.

fm toolroom.read [--only=VALUE] [--prefix=VALUE]
Parameter Type Default Description
--only=VALUE "" regenerate just this tool
--prefix=VALUE "" read binaries from this prefix's bin/

Example

$ fm toolroom.read