Reference · command

metais sample

Generate sample data from the inputs' schemas, and keep it as a data directory or an example.

Supplying and rendering

Usage

metais sample [<package>] (--out <dir> | --example <name>) [--optional <mode>] [--seed <n>] [--items <n>] [supply flags] [--overwrite] [--dry-run] [--json]

Examples

metais sample report-1.0.0.metais --out data
Writes sample data for the package into the new directory data, which render --data data reads.
metais sample --out data
Writes sample data for the source directory in the working directory into the new directory data.
metais sample report-1.0.0.metais --out data --seed 7 --optional mixed
Writes other data, with some optional fields left out.
metais sample --example staged --set /incident/stage=final
Saves data whose stage is final as the example staged.
metais sample --out data --overwrite --json
Replaces the data files in data, and lists them as one metais.sample/1 document.

Detail

sample serves an author, and a person who asked for an example, sample data or a preview of what the package produces: metais render --data reads the data directory it writes, and metais render --sample renders from the same data without keeping it. Generated data never stands in for the facts a real document needs: without them, ask the person for them.

The generator makes a value for every input from its schema: the schema's const, examples, default or enum where it has one, and otherwise placeholder text, numbers and dates of its own. Values given with --set, --set-json and --inputs-json are fixed points: they are kept as given, conditionals evaluated against them, and only what they leave out is made. The same package, options, supplied values and seed give the same data on every platform.

The data is written as a data directory, one file per input in its first form and one directory per collection, and is read back and validated exactly as metais render --data reads it, before anything is written. A field the generator cannot make a valid value for is schema.sample_unsatisfiable, and data that fails its schema, such as a supplied value the schema refuses, is schema.sample_invalid; with any error nothing is written.

With --out, the data directory is <dir>: a <dir> that does not exist is created, with its missing parents, beside it and renamed into place; an empty one is written into. A <dir> that holds any entry, a hidden one included, is refused unless --overwrite is given, and then each file sample writes replaces the file of that name, and nothing else in <dir> is read, changed or removed. Everything sample writes into an existing <dir>, an empty collection's directory included, is prepared beneath <dir>/.metais-staging and moved into place. A link, a directory or a special file where sample writes a file, a file where it needs a directory, and a name that differs only in case from one it writes are each refused, all of them together, before anything is written.

With --example, the source directory's examples/<name>/ is written: its inputs/ holds the data, and its example.yaml records how it was made. It is refused with a packed package, and when examples/<name>/ exists at all; nothing in an example is ever replaced. An example is the author's illustration of the inputs, and of the outputs a render of them should produce, kept in the package to test it: not your data, and not a preview of what the package produces, which is a render from generated data with metais render --sample. --dry-run lists the files and writes nothing.

Operands

<package>
A source directory, or a packed package file with --out; the current directory when omitted. - is refused, since a package is read with random access.

Flags

--out <dir>
The directory to write the data directory into: one that does not exist yet, or an empty one, or with --overwrite any directory.
--example <name>
Save the data as the inputs of a new example, examples/<name>/, of the source directory.
--optional <mode>
Which optional properties and inputs the generator makes: all of them, none (and null wherever null is allowed), or a mix the seed decides. Values: all, none, mixed. Default: all.
--seed <n>
The generator's seed, an unsigned 64-bit integer: the same package, options, supplied values and seed give the same data. Default: 0.
--items <n>
The number of items the generator aims for in every array and collection, within the schema's bounds. Default: 3.
--set <pointer>=<text>
Set one value at an inputs pointer, such as /vendor/name=Acme; the text is coerced to the type the schema declares there. Applied after --data and --inputs-json, in command-line order with --set-json. May be given more than once.
--set-json <pointer>=<json>
Set one value at an inputs pointer as JSON text, the way to set null, an array or an object. Applied in command-line order with --set. May be given more than once.
--inputs-json <json>
A JSON object whose members are inputs, each replacing that input's whole value; - reads it from standard input, once. Applied after --data, in command-line order. May be given more than once.
--overwrite
With --out, write into a directory that holds entries, replacing the files sample writes and nothing else.
--dry-run
Generate and validate the data, list the files sample would write, and write nothing.
--limit <name>=<value>
Lower one resource limit for this run, to a whole number no higher than its default (a size may end in KiB, MiB or GiB). metais limits lists them. May be given more than once.
--fail-on <severity>
With warning, a warning fails the command with exit status 1 as an error does; no finding's severity changes. Values: error, warning. Default: error.
--json
Print the result as one JSON document on standard output.
--color <when>
Colour human output: auto colours a stream that is a terminal when NO_COLOR is unset or empty; always and never override NO_COLOR. Values: auto, always, never. Default: auto.
-h, --help
Print help to standard output and exit 0; nothing else runs.

Prints

The files written, relative to <dir> or to examples/<name>/, in path order; an empty directory, a collection with no item, is listed with a trailing /.

--json: metais.sample/1

Refusals

collection.as_file
A value given with --set, --set-json or --inputs-json is refused (as file). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
collection.directory_name
A value given with --set, --set-json or --inputs-json is refused (directory name). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
collection.item_name
A value given with --set, --set-json or --inputs-json is refused (item name). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
collection.stem_duplicate
A value given with --set, --set-json or --inputs-json is refused (stem duplicate). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
collection.subdirectory
A value given with --set, --set-json or --inputs-json is refused (subdirectory). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
csv.after_quote
A value given with --set, --set-json or --inputs-json is refused (after quote). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
csv.bare_quote
A value given with --set, --set-json or --inputs-json is refused (bare quote). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
csv.field_count
A value given with --set, --set-json or --inputs-json is refused (field count). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
csv.header_duplicate
A value given with --set, --set-json or --inputs-json is refused (header duplicate). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
csv.header_empty
A value given with --set, --set-json or --inputs-json is refused (header empty). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
csv.header_missing
A value given with --set, --set-json or --inputs-json is refused (header missing). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
csv.unterminated_quote
A value given with --set, --set-json or --inputs-json is refused (unterminated quote). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.additional_item
A value given with --set, --set-json or --inputs-json is refused (additional item). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.additional_property
A value given with --set, --set-json or --inputs-json is refused (additional property). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.any_of
A value given with --set, --set-json or --inputs-json is refused (any of). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.const
A value given with --set, --set-json or --inputs-json is refused (const). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.constraints_failed
A value given with --set, --set-json or --inputs-json is refused (constraints failed). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.constraints_not_evaluated
A value given with --set, --set-json or --inputs-json is refused (constraints not evaluated). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.contains
A value given with --set, --set-json or --inputs-json is refused (contains). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.coverage
A value given with --set, --set-json or --inputs-json is refused (coverage). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.dependent_required
A value given with --set, --set-json or --inputs-json is refused (dependent required). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.encoding_invalid
A value given with --set, --set-json or --inputs-json is refused (encoding invalid). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.enum
A value given with --set, --set-json or --inputs-json is refused (enum). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.exclusive_maximum
A value given with --set, --set-json or --inputs-json is refused (exclusive maximum). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.exclusive_minimum
A value given with --set, --set-json or --inputs-json is refused (exclusive minimum). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.extension_not_accepted
A value given with --set, --set-json or --inputs-json is refused (extension not accepted). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.file_duplicate
A value given with --set, --set-json or --inputs-json is refused (file duplicate). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.file_unknown
A value given with --set, --set-json or --inputs-json is refused (file unknown). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.forbidden
A value given with --set, --set-json or --inputs-json is refused (forbidden). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.format
A value given with --set, --set-json or --inputs-json is refused (format). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.json_arg_invalid
A value given with --set, --set-json or --inputs-json is refused (json arg invalid). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.json_arg_not_object
A value given with --set, --set-json or --inputs-json is refused (json arg not object). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.json_arg_unknown
A value given with --set, --set-json or --inputs-json is refused (json arg unknown). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
A value given with --set, --set-json or --inputs-json is refused (link). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.max_contains
A value given with --set, --set-json or --inputs-json is refused (max contains). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.max_items
A value given with --set, --set-json or --inputs-json is refused (max items). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.max_length
A value given with --set, --set-json or --inputs-json is refused (max length). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.max_properties
A value given with --set, --set-json or --inputs-json is refused (max properties). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.maximum
A value given with --set, --set-json or --inputs-json is refused (maximum). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.min_contains
A value given with --set, --set-json or --inputs-json is refused (min contains). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.min_items
A value given with --set, --set-json or --inputs-json is refused (min items). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.min_length
A value given with --set, --set-json or --inputs-json is refused (min length). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.min_properties
A value given with --set, --set-json or --inputs-json is refused (min properties). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.minimum
A value given with --set, --set-json or --inputs-json is refused (minimum). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.missing
A value given with --set, --set-json or --inputs-json is refused (missing). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.multiple_of
A value given with --set, --set-json or --inputs-json is refused (multiple of). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.noncharacter
A value given with --set, --set-json or --inputs-json is refused (noncharacter). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.not
A value given with --set, --set-json or --inputs-json is refused (not). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.not_readable
A value given with --set, --set-json or --inputs-json is refused (not readable). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.not_regular_file
A value given with --set, --set-json or --inputs-json is refused (not regular file). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.number_out_of_range
A value given with --set, --set-json or --inputs-json is refused (number out of range). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.one_of
A value given with --set, --set-json or --inputs-json is refused (one of). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.one_of.ambiguous
A value given with --set, --set-json or --inputs-json is refused (one of: ambiguous). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.pattern
A value given with --set, --set-json or --inputs-json is refused (pattern). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.property_name
A value given with --set, --set-json or --inputs-json is refused (property name). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.raw_unavailable
A value given with --set, --set-json or --inputs-json is refused (raw unavailable). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.required
A value given with --set, --set-json or --inputs-json is refused (required). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.set_into_unparsed
A value given with --set, --set-json or --inputs-json is refused (set into unparsed). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.set_pointer_invalid
A value given with --set, --set-json or --inputs-json is refused (set pointer invalid). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.set_traversal
A value given with --set, --set-json or --inputs-json is refused (set traversal). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.type
A value given with --set, --set-json or --inputs-json is refused (type). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.unevaluated_item
A value given with --set, --set-json or --inputs-json is refused (unevaluated item). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.unevaluated_property
A value given with --set, --set-json or --inputs-json is refused (unevaluated property). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.unique_items
A value given with --set, --set-json or --inputs-json is refused (unique items). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.unique_keys
A value given with --set, --set-json or --inputs-json is refused (unique keys). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
input.validation.partial
A value given with --set, --set-json or --inputs-json is refused (validation: partial). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
json.duplicate_name
A value given with --set, --set-json or --inputs-json is refused (duplicate name). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
json.lone_surrogate
A value given with --set, --set-json or --inputs-json is refused (lone surrogate). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
json.noncharacter
A value given with --set, --set-json or --inputs-json is refused (noncharacter). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
json.syntax
A value given with --set, --set-json or --inputs-json is refused (syntax). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
json.trailing_content
A value given with --set, --set-json or --inputs-json is refused (trailing content). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
limit.exceeded
A value given with --set, --set-json or --inputs-json is refused (exceeded). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
limit.invalid
A --limit names no limit, gives a malformed value, or tries to raise one. Next: metais limits: Lists every limit with its default; a limit can be lowered and never raised.
limit.package
The package breaches one of its limits. Next: metais limits: Lists every limit with its default; a limit can be lowered and never raised.
manifest.additional_property
The manifest breaks one of its rules (additional property). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.const
The manifest breaks one of its rules (const). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.contains
The manifest breaks one of its rules (contains). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.dependent_required
The manifest breaks one of its rules (dependent required). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.enum
The manifest breaks one of its rules (enum). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.file.wrong_name
The manifest breaks one of its rules (file: wrong name). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.forbidden
The manifest breaks one of its rules (forbidden). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.input.duplicate_name
The manifest breaks one of its rules (input: duplicate name). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.json.duplicate_name
The manifest breaks one of its rules (json: duplicate name). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.json.encoding
The manifest breaks one of its rules (json: encoding). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.json.lone_surrogate
The manifest breaks one of its rules (json: lone surrogate). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.json.noncharacter
The manifest breaks one of its rules (json: noncharacter). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.json.syntax
The manifest breaks one of its rules (json: syntax). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.json.trailing_content
The manifest breaks one of its rules (json: trailing content). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.license.expression
The manifest breaks one of its rules (license: expression). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.max_items
The manifest breaks one of its rules (max items). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.max_length
The manifest breaks one of its rules (max length). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.min_items
The manifest breaks one of its rules (min items). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.min_length
The manifest breaks one of its rules (min length). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.not
The manifest breaks one of its rules (not). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.number_out_of_range
The manifest breaks one of its rules (number out of range). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.one_of
The manifest breaks one of its rules (one of). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.output.duplicate_id
The manifest breaks one of its rules (output: duplicate id). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.output.nested_for_each
The manifest breaks one of its rules (output: nested for each). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.path_not_found
The manifest breaks one of its rules (path not found). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.pattern
The manifest breaks one of its rules (pattern). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.required
The manifest breaks one of its rules (required). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.type
The manifest breaks one of its rules (type). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.unique_items
The manifest breaks one of its rules (unique items). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.alias
The manifest breaks one of its rules (yaml: alias). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.anchor
The manifest breaks one of its rules (yaml: anchor). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.bom
The manifest breaks one of its rules (yaml: bom). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.character
The manifest breaks one of its rules (yaml: character). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.directive
The manifest breaks one of its rules (yaml: directive). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.duplicate_key
The manifest breaks one of its rules (yaml: duplicate key). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.encoding
The manifest breaks one of its rules (yaml: encoding). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.key_empty
The manifest breaks one of its rules (yaml: key empty). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.key_not_scalar
The manifest breaks one of its rules (yaml: key not scalar). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.merge_key
The manifest breaks one of its rules (yaml: merge key). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.multi_document
The manifest breaks one of its rules (yaml: multi document). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.root_not_mapping
The manifest breaks one of its rules (yaml: root not mapping). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.scalar_refused
The manifest breaks one of its rules (yaml: scalar refused). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.syntax
The manifest breaks one of its rules (yaml: syntax). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
manifest.yaml.tag
The manifest breaks one of its rules (yaml: tag). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
markdown.frontmatter_body_field
A value given with --set, --set-json or --inputs-json is refused (frontmatter body field). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
markdown.frontmatter_not_mapping
A value given with --set, --set-json or --inputs-json is refused (frontmatter not mapping). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
markdown.frontmatter_unclosed
A value given with --set, --set-json or --inputs-json is refused (frontmatter unclosed). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
output.destination.case_variant
In <dir>, an entry's name differs only in case or normalization from a name a path sample writes holds. Next: metais sample <package> --out <dir>: Writes again once what stands in the way in <dir> is moved or removed, or into a directory that does not exist yet.
output.destination.commit_failed
Moving the files into an existing <dir> failed part way; the files already moved are listed, and nothing else was changed. Next: metais sample <package> --out <dir>: Writes the sample data as a data directory into a directory that is empty or does not exist yet.
In <dir>, a path sample writes runs through, or ends at, a symbolic link, a junction or another reparse point, which is never followed. Next: metais sample <package> --out <dir>: Writes again once what stands in the way in <dir> is moved or removed, or into a directory that does not exist yet.
output.destination.not_directory
--out, or a directory above it, exists and is not a directory; or, in <dir>, a file stands where a path sample writes needs a directory. Next: metais sample <package> --out <dir>: Writes again once what stands in the way in <dir> is moved or removed, or into a directory that does not exist yet.
output.destination.not_empty
--out names a directory that holds entries, and --overwrite is not given. Next: metais sample <package> --out <dir> --overwrite: Writes into the directory anyway, replacing the files sample writes and leaving every other file as it is.
output.destination.not_regular_file
In <dir>, a directory, a named pipe, a socket or a device stands where sample writes a file. Next: metais sample <package> --out <dir>: Writes again once what stands in the way in <dir> is moved or removed, or into a directory that does not exist yet.
output.destination.nothing_written
A write failed, another file system is mounted on a path sample writes, or the example already exists; nothing is left written. Next: metais sample <package> --out <dir>: Writes the sample data as a data directory into a directory that is empty or does not exist yet.
output.destination.staging_exists
<dir> holds .metais-staging, left by a killed write or in use by another; nothing is written. Next: metais sample <package> --out <dir>: Writes the sample data as a data directory into a directory that is empty or does not exist yet.
package.compiled.mismatch
The package is refused (compiled: mismatch). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.compiled.missing
The package is refused (compiled: missing). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.compiled.unknown_file
The package is refused (compiled: unknown file). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.archive_comment
The package is refused (container: archive comment). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.crc_mismatch
The package is refused (container: crc mismatch). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.data_descriptor
The package is refused (container: data descriptor). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.deflate_stream
The package is refused (container: deflate stream). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.encrypted
The package is refused (container: encrypted). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.entry_order
The package is refused (container: entry order). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.extra_field
The package is refused (container: extra field). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.field_value
The package is refused (container: field value). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.flags
The package is refused (container: flags). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.header_mismatch
The package is refused (container: header mismatch). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.method
The package is refused (container: method). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.not_zip
The package is refused (container: not zip). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.overlap_or_gap
The package is refused (container: overlap or gap). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.prepended_data
The package is refused (container: prepended data). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.second_end_record
The package is refused (container: second end record). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.size_mismatch
The package is refused (container: size mismatch). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.trailing_data
The package is refused (container: trailing data). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.container.zip64
The package is refused (container: zip64). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.digest.entries_mismatch
The package is refused (digest: entries mismatch). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.digest.mismatch
The package is refused (digest: mismatch). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.digest.not_canonical
The package is refused (digest: not canonical). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.digest.package_mismatch
The package is refused (digest: package mismatch). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.layout.compiled_in_source
The package is refused (layout: compiled in source). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.layout.empty_directory
The package is refused (layout: empty directory). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.layout.missing_manifest
The package is refused (layout: missing manifest). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.layout.non_regular_file
The package is refused (layout: non regular file). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.layout.readme
The package is refused (layout: readme). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.layout.unknown_top_level
The package is refused (layout: unknown top level). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.case_collision
The package is refused (name: case collision). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.character
The package is refused (name: character). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.directory_entry
The package is refused (name: directory entry). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.duplicate
The package is refused (name: duplicate). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.encoding
The package is refused (name: encoding). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.file_directory_conflict
The package is refused (name: file directory conflict). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.not_nfc
The package is refused (name: not nfc). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.not_portable
The package is refused (name: not portable). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.name.shape
The package is refused (name: shape). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.not_found
The package is refused (not found). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.not_readable
The package is refused (not readable). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.version.malformed
The package is refused (version: malformed). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.version.missing
The package is refused (version: missing). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.version.not_string
The package is refused (version: not string). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.version.unsupported_major
The package is refused (version: unsupported major). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
package.version.unsupported_minor
The package is refused (version: unsupported minor). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.dialect
An input schema is refused (dialect). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.format_unsupported
An input schema is refused (format unsupported). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.id_duplicate
An input schema is refused (id duplicate). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.invalid
An input schema is refused (invalid). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.keyword_unknown
An input schema is refused (keyword unknown). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.pattern_unsupported
An input schema is refused (pattern unsupported). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.ref_by_path
An input schema is refused (ref by path). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.ref_escapes
An input schema is refused (ref escapes). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.ref_unresolved
An input schema is refused (ref unresolved). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
schema.sample_invalid
The generated data cannot be made or does not validate (sample invalid). Next: metais schema <package> <name> --fields: Lists the fields of the input named in the finding, one line each with its constraints; add an examples value they allow to the field named, in the schema file the finding locates, and the generator uses it.
schema.sample_unsatisfiable
The generated data cannot be made or does not validate (sample unsatisfiable). Next: metais schema <package> <name> --fields: Lists the fields of the input named in the finding, one line each with its constraints; add an examples value they allow to the field named, in the schema file the finding locates, and the generator uses it.
schema.syntax
An input schema is refused (syntax). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.amount_currency
An output's path, when or for_each does not parse (amount currency). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.date_format
An output's path, when or for_each does not parse (date format). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.division_by_zero
An output's path, when or for_each does not parse (division by zero). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.duration_format
An output's path, when or for_each does not parse (duration format). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.filter_argument
An output's path, when or for_each does not parse (filter argument). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.include
An output's path, when or for_each does not parse (include). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.number_range
An output's path, when or for_each does not parse (number range). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.safe_position
An output's path, when or for_each does not parse (safe position). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.syntax
An output's path, when or for_each does not parse (syntax). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.tag_context
An output's path, when or for_each does not parse (tag context). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
template.unknown_filter
An output's path, when or for_each does not parse (unknown filter). Next: metais inspect <package>: Opens the package again once it is fixed or replaced; nothing of a refused package is used.
usage.bad_value
A flag's value is missing, or is not one the flag accepts, or a flag that takes no value is given one. Next: metais sample --help: Prints the operands and flags metais sample takes.
usage.bad_value
--seed or --items is not a whole number in range, or --example is not a name an example can have. Next: metais sample --help: Prints the operands and flags metais sample takes.
usage.conflicting_flags
--inputs-json - is given twice, and standard input is read once. Next: metais help inputs: Explains how inputs are supplied: the data directory, --inputs-json, --set and --set-json.
usage.flag_excluded
--out and --example are both given, or --overwrite is given with --example. Next: metais sample --help: Prints the operands and flags metais sample takes.
usage.missing_operand
The package operand is not given. Next: metais sample --help: Prints the operands and flags metais sample takes.
usage.not_a_source_directory
--example is given with a packed package, whose examples are not edited. Next: metais unpack <package> --out <dir>: Writes the packed package's source directory, which sample --example can save an example into.
usage.package_from_stdin
The package operand is -, standard input. Next: metais sample --help: Prints the operands and flags metais sample takes.
usage.repeated_flag
A flag that may be given once is given again. Next: metais sample --help: Prints the operands and flags metais sample takes.
usage.unexpected_operand
An operand the command does not take. Next: metais sample --help: Prints the operands and flags metais sample takes.
usage.unknown_flag
An argument that is not a flag the command accepts, an abbreviated flag, or one-letter aliases written together. Next: metais sample --help: Prints the operands and flags metais sample takes.
yaml.alias
A value given with --set, --set-json or --inputs-json is refused (alias). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.anchor
A value given with --set, --set-json or --inputs-json is refused (anchor). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.bom
A value given with --set, --set-json or --inputs-json is refused (bom). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.character
A value given with --set, --set-json or --inputs-json is refused (character). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.directive
A value given with --set, --set-json or --inputs-json is refused (directive). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.duplicate_key
A value given with --set, --set-json or --inputs-json is refused (duplicate key). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.key_empty
A value given with --set, --set-json or --inputs-json is refused (key empty). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.key_not_scalar
A value given with --set, --set-json or --inputs-json is refused (key not scalar). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.merge_key
A value given with --set, --set-json or --inputs-json is refused (merge key). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.multi_document
A value given with --set, --set-json or --inputs-json is refused (multi document). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.scalar_refused
A value given with --set, --set-json or --inputs-json is refused (scalar refused). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.syntax
A value given with --set, --set-json or --inputs-json is refused (syntax). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.
yaml.tag
A value given with --set, --set-json or --inputs-json is refused (tag). Next: metais inspect <package>: Lists the inputs the package takes; a value given with --set, --set-json or --inputs-json is kept as given and must be one the schema allows.