envzn
0.8 · beta · not released

Library / Concurrency / Contracts / TaskStarterOptions

INTERFACE

TaskStarterOptions

TaskStarterOptions — the options class of a program that takes arguments . The developer declares plain fields, blittable or String, and sets their defaults in INIT; the compiler writes all three methods from those fields and the manifest's entrypoint.options block, and the developer never writes or calls them. EntryOptions[T].fill calls describe and load; the program calls forwarded when it hands options on to another program.

Methods 3

METHOD describe(MUTABLE REFERENCE CommandLineArguments args) RETURNS void
reads

Declare one option per field to args, with the manifest's help, alias, required and positional settings and INIT's value as the default.

MODIFY METHOD load(REFERENCE CommandLineArguments args) RETURNS STATUS
modifies

Copy each parsed value into its field. FAILURE when a value breaks a rule the field's type carries (an enum's case names), which is a usage error.

METHOD forwarded(REFERENCE String destination) RETURNS String[]
reads

The command-line words to hand to destination: every option the manifest marks "forward": destination that the user gave, as given, then the words after -- when "after-double-dash" names it (§3a). Empty otherwise.