optio

Declares a CLI option annotation.

Syntax: @ optio <binding> [brevis \"x\"] [longum \"name\"] [typus <type>] [descriptio \"...\"] [ubique] [vel <default>]

Category

cli

Related

• optio
• cli
• annotation-sugar

Examples

examples/corpus/annotation-sugar/optio-braced.fab (canonical · annotation)

Braced canonical @ optio CLI option record.

# Braced @ optio — canonical option record
#
# TARGET: annotation-sugar stage 2
# PAIR: sugar `@ optio NAME brevis \"x\" ...` (see optio/optio.fab)

@ cli { nomen = "optio-braced-smoke" }
@ optio {
    binding = verbose,
    brevis = "v",
    longum = "verbose",
    typus = bivalens,
    descriptio = "Verbose mode",
    ubique = verum,
}
incipit argumenta args { }

examples/corpus/optio/optio.fab (canonical · keyword)

Declares a CLI option annotation.

# optio — CLI option annotation
#
# GRAMMAR:
#   annotation :← '@' 'optio' optionSpec
#
# EXPECTED OUTPUT:
#   No incipit — declaration or test-runner surface only.
#
# BACKEND:
#   declaration-only CLI metadata (whitelist: optio/optio.fab).
#

@ cli "optio-smoke"
@ optio verbose brevis "v" longum "verbose" typus bivalens descriptio "Verbose mode"
@ optio count longum "count" typus numerus descriptio "Repeat count"
incipit argumenta args {
}