operand

Declares a CLI operand annotation.

Syntax: @ operand [rest] <type> <binding> [description \"...\"] [ubique] [vel <default>]

Category#

cli

Related#

• option
• cli
• imperium
• rest
• global

Examples#

radix/corpus/operandus/operandus.fab (canonical · keyword)#

Declares a CLI operand annotation.

# =============================================================================
# operand — Declares a CLI operand annotation.
# =============================================================================
#
# What this teaches:
#   • CLI operands — `@operand` declares positional arguments for CLI subcommands.
#   • Binding and description — Each operand specifies a type, binding name, and description.
#   • Variadic operands — The `rest` keyword marks an operand that consumes remaining arguments.
#
# Common mistakes:
#   • Duplicate operand bindings or type mismatches — each operand name must be unique and match its declared type.
#
# See also: option, cli, command, rest, global
# =============================================================================

# operand — CLI positional operand
#
# GRAMMAR:
#   annotation :← '@' 'operand' operandSpec
#
# EXPECTED OUTPUT:
#   No main — declaration or test-runner surface only.
#
# BACKEND:
#   declaration-only CLI metadata (whitelist: operand/operandus.fab).
#

@ cli "operandus-smoke"
@ operand string input description "Input path"
@ operand rest string files description "Extra files"
main args args {
}