Skip to main content

Command template

Command templates are used to map the input to any desired command.

Mapping flags

Can be done in two ways:

  • Interpolating the string value of flags (i.e. false or true) into the command string
  • Interpolating or not, a predefined identifier based on the truthness of the flag
mapping-flags.cli
hello-world(goodDay: flag) {
    sub foo {
        action "echo Hello World $(goodDay)"
    }
    sub bar {
        action "echo Hello World $(goodDay:today-is-a-good-day)"
    }
    sub baz {
        action "echo Hello World $(!goodDay:today-is-NOT-a-good-day)"
    }
}

When executing foo, the flag goodDay's value will just be interpolated into the string

When executing bar, the flag will decide whether the string today-is-a-good-day is interpolated, or not

When executing baz, the effect will be the same as for bar, only the flag will be inverted

Console
$ hello-world foo
Hello World false

$ hello-world --goodDay foo
Hello World true

$ hello-world bar
Hello World

$ hello-world --goodDay bar
Hello World today-is-a-good-day

$ hello-world baz
Hello World today-is-NOT-a-good-day

$ hello-world --goodDay baz
Hello World

Mapping args

Similar to flags, mapping args can be done in two ways:

  • Interpolating the value
  • Interpolating with a key prefix
mapping-args.cli
hello-world(dayOfTheWeek: arg) {
    sub foo {
        action "echo Hello World $(dayOfTheWeek)"
    }
    sub bar {
        action "echo Hello World $(dayOfTheWeek:--today-is)"
    }
}
Console
$ hello-world Tuesday foo
Hello World Tuesday

$ hello-world Tuesday bar
Hello World --today-is=Tuesday