Skip to content

Terminology

Martin Pool edited this page Nov 7, 2022 · 4 revisions

Try to use the same terms for the same concepts consistently in code, UI, and documentation.

(However, the current code is not yet 100% consistent with this.)

  • Source tree - The original, unmodified tree: either the working directory where cargo mutants is run, or the argument to -d.

  • Build dir - A copy of the source with mutations applied.

  • Mutation - a general pattern of mutation we can apply, like "replace with ()". (Currently the code says "MutationOp" for this.)

  • Mutant - the result of applying a mutation at one particular site; the unit for testing.

  • Phase - check, build, run - one cargo command while running a scenario.

  • Site - a span in a source tree (currently always a whole function) at which a mutation can be applied

  • Scenario - one kind of build/check/test: either in the source, a baseline, or a mutant

  • Activity - glue to the console UI/progress bar indicating that a particular activity is underway: either a tree copy or testing of some scenario

  • Lab - the result of running all the different mutants; maybe should be renamed to Suite or Panel or something?

Clone this wiki locally