Command::multicall

multicall

since 0.1.0

Multiple-personality program dispatched on the binary name (argv[0]).

Examples

Example 1

Spec

TOML

name = "busybox"
multicall = true
[args]
[[subcommands]]
name = "busybox"
subcommand-value-name = "APPLET"
subcommand-help-heading = "APPLETS"
[[subcommands.subcommands]]
name = "true"
[[subcommands.subcommands]]
name = "false"

YAML

name: busybox
multicall: true
args: {}
subcommands:
- name: busybox
  subcommand-value-name: APPLET
  subcommand-help-heading: APPLETS
  subcommands:
  - name: 'true'
  - name: 'false'

JSON

{
  "name": "busybox",
  "multicall": true,
  "args": {},
  "subcommands": [
    {
      "name": "busybox",
      "subcommand-value-name": "APPLET",
      "subcommand-help-heading": "APPLETS",
      "subcommands": [
        {
          "name": "true"
        },
        {
          "name": "false"
        }
      ]
    }
  ]
}

Input

/usr/bin/busybox true

Output

claptrap__subcommand='busybox::true'

Example 2

Spec

TOML

name = "busybox"
multicall = true
[args]
[[subcommands]]
name = "busybox"
subcommand-value-name = "APPLET"
subcommand-help-heading = "APPLETS"
[[subcommands.subcommands]]
name = "true"
[[subcommands.subcommands]]
name = "false"
[[subcommands]]
name = "true"
[[subcommands]]
name = "false"

YAML

name: busybox
multicall: true
args: {}
subcommands:
- name: busybox
  subcommand-value-name: APPLET
  subcommand-help-heading: APPLETS
  subcommands:
  - name: 'true'
  - name: 'false'
- name: 'true'
- name: 'false'

JSON

{
  "name": "busybox",
  "multicall": true,
  "args": {},
  "subcommands": [
    {
      "name": "busybox",
      "subcommand-value-name": "APPLET",
      "subcommand-help-heading": "APPLETS",
      "subcommands": [
        {
          "name": "true"
        },
        {
          "name": "false"
        }
      ]
    },
    {
      "name": "true"
    },
    {
      "name": "false"
    }
  ]
}

Input

/usr/bin/true

Output

claptrap__subcommand='true'

Example 3

Spec

TOML

name = "hostname"
multicall = true
[args]
[[subcommands]]
name = "hostname"
[[subcommands]]
name = "dnsdomainname"

YAML

name: hostname
multicall: true
args: {}
subcommands:
- name: hostname
- name: dnsdomainname

JSON

{
  "name": "hostname",
  "multicall": true,
  "args": {},
  "subcommands": [
    {
      "name": "hostname"
    },
    {
      "name": "dnsdomainname"
    }
  ]
}

Input

/usr/bin/hostname dnsdomainname

Output

error: unexpected argument 'dnsdomainname' found

Usage: hostname

For more information, try '--help'.