معامل

Declares a CLI operand annotation.

Syntax: @ معامل [باقي] <type> <binding> [وصف \"...\"] [ubique] [vel <default>]

Category#

cli

Related#

• خيار
• cli
• imperium
• باقي
• عمومي

Examples#

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

Declares a CLI operand annotation.

# =============================================================================
# معامل — Declares a CLI operand annotation.
# =============================================================================
#
# What this teaches:
#   • CLI operands — `@معامل` declares positional arguments for CLI subcommands.
#   • Binding and description — Each operand specifies a type, binding name, and description.
#   • Variadic operands — The `باقي` 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: خيار, cli, أمر, باقي, عمومي
# =============================================================================

# معامل — CLI positional operand
#
# GRAMMAR:
#   annotation :← '@' 'معامل' operandSpec
#
# EXPECTED OUTPUT:
#   No بداية — declaration or test-runner surface only.
#
# BACKEND:
#   declaration-only CLI metadata (whitelist: معامل/operandus.fab).
#

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