Boolean False

An argument of the boolean_false type acts like an inverted boolean flag with a default value of true. When called as an argument it sets the boolean to false.

Example:

arguments:
  - name: --no-log
    type: boolean_false
    description: Disable logging
    alternatives: ["-nl"]

alternatives

Type: String / List of String

Default: Empty

List of alternative format variations for this argument.

description

Type: String

Default: Empty

A description of the argument. This is only used for documentation. Multiline descriptions are supported.

Example:

description: |
  A (multiline) description of the purpose of
  this argument.

info

Type: Json

Default: Empty

Structured information. Can be any shape: a string, vector, map or even nested map.

Example:

info:
  category: cat1
  labels: [one, two, three]

label

Type: String

Default: Empty

A clean version of the argument’s name. This is only used for documentation.

Example:

label: "My argument"

name

Type: String

The name of the argument. Can be in the formats --no-log, -n or no-log. The number of dashes determines how values can be passed:

  • --no-log is a long option, which can be passed with executable_name --no-log
  • -n is a short option, which can be passed with executable_name -n
  • no-log is an argument, which can be passed with executable_name no-log

summary

Type: String

Default: Empty

A one-sentence summary of the argument. This is only used for documentation.

Example:

summary: "This argument sets XYZ."

type

Type: String

Specifies the type of the argument.