ansibleSpec top-level property

FigSpec ansibleSpec

Completion spec for ansible CLI

Implementation

final FigSpec ansibleSpec = FigSpec(
  name: 'ansible',
  description: 'Define and run a single Ansible task \'playbook\' against a set of hosts',
  args: [
    Arg(
    name: 'pattern',
    description: 'Host pattern'
  )
  ],
  options: [

    Option(
      name: '--ask-vault-pass',
      description: 'Ask for vault password'
    ),
    Option(
      name: '--list-hosts',
      description: 'Outputs a list of matching hosts; does not execute'
    ),
    Option(
      name: '--playbook-dir',
      description: 'Since this tool does not use playbooks, use this as a substitute playbook directory.This sets the relative path for many features including roles/ group_vars/etc',
      args: [
        Arg(
        name: 'playbook dir',
        template: ['folders']
      )
      ]
    ),
    Option(
      name: '--syntax-check',
      description: 'Perform a syntax check on the playbook, but do not execute it'
    ),
    Option(
      name: '--vault-id',
      description: 'Specify the vault identity to use',
      args: [
        Arg(
        name: 'vault ID'
      )
      ]
    ),
    Option(
      name: '--vault-password-file',
      description: 'Specify a vault password file',
      args: [
        Arg(
        name: 'vault password file',
        template: ['filepaths']
      )
      ]
    ),
    Option(
      name: '--version',
      description: 'Show program\'s version number, config file location, configured module search path, module location and executable location'
    ),
    Option(
      name: ['--background', '-B'],
      description: 'Run asynchronously, failing after specified seconds',
      args: [
        Arg(
        name: 'seconds'
      )
      ]
    ),
    Option(
      name: ['--check', '-C'],
      description: 'Don\'t make any changes; instead, try to predict some of the changes that may occur'
    ),
    Option(
      name: ['--diff', '-D'],
      description: 'When changing (small) files and templates, show the differences in those files'
    ),
    Option(
      name: ['--module-path', '-M'],
      description: 'Prepend colon-separated path(s) to module library',
      args: [
        Arg(
        name: 'module path',
        template: ['folders']
      )
      ]
    ),
    Option(
      name: ['--poll', '-P'],
      description: 'Set the poll interval if using -B',
      args: [
        Arg(
        name: 'poll interval'
      )
      ]
    ),
    Option(
      name: ['--args', '-a'],
      description: 'Specify module arguments',
      args: [
        Arg(
        name: 'module arguments'
      )
      ]
    ),
    Option(
      name: ['--extra-vars', '-e'],
      description: 'Set additional variables as key=value or YAML/JSON, if filename prepend with @',
      args: [
        Arg(
        name: 'extra vars'
      )
      ]
    ),
    Option(
      name: ['--forks', '-f'],
      description: 'Specify number of parallel processes to use',
      args: [
        Arg(
        name: 'forks'
      )
      ]
    ),
    Option(
      name: ['--help', '-h'],
      description: 'Show help for ansible'
    ),
    Option(
      name: ['--inventory', '-i'],
      description: 'Specify inventory host path or comma separated host list',
      args: [
        Arg(
        name: 'inventory'
      )
      ]
    ),
    Option(
      name: ['--limit', '-l'],
      description: 'Limit selected hosts to an additional pattern',
      args: [
        Arg(
        name: 'subset'
      )
      ]
    ),
    Option(
      name: ['--module-name', '-m'],
      description: 'Specify the module name to execute',
      args: [
        Arg(
        name: 'module name'
      )
      ]
    ),
    Option(
      name: ['--one-line', '-o'],
      description: 'Condense output'
    ),
    Option(
      name: ['--tree', '-t'],
      description: 'Log output to specific directory',
      args: [
        Arg(
        name: 'tree'
      )
      ]
    ),
    Option(
      name: ['--verbose', '-v'],
      description: 'Enable verbose mode'
    ),
    Option(
      name: '-vvv',
      description: 'Enable very verbose mode'
    ),
    Option(
      name: '-vvvv',
      description: 'Enable connection debug mode'
    ),
    Option(
      name: '--become-method',
      description: 'Privilege escalation method to use',
      args: [
        Arg(
        name: 'become method',
        suggestions: [

          FigSuggestion(name: 'sudo'),
          FigSuggestion(name: 'su'),
          FigSuggestion(name: 'pbrun'),
          FigSuggestion(name: 'pfexec'),
          FigSuggestion(name: 'doas'),
          FigSuggestion(name: 'dzdo'),
          FigSuggestion(name: 'ksu'),
          FigSuggestion(name: 'runas'),
          FigSuggestion(name: 'machinectl')
        ]
      )
      ]
    ),
    Option(
      name: '--become-user',
      description: 'Privilege escalation user to use',
      args: [
        Arg(
        name: 'become user'
      )
      ]
    ),
    Option(
      name: ['--ask-become-pass', '-K'],
      description: 'Prompt for privilege escalation password'
    ),
    Option(
      name: ['--become', '-b'],
      description: 'Run operations with become'
    ),
    Option(
      name: ['--private-key', '--key-file'],
      description: 'Use this fole to authenticate the connection',
      args: [
        Arg(
        name: 'private key',
        template: ['filepaths']
      )
      ]
    ),
    Option(
      name: '--scp-extra-args',
      description: 'Extra arguments to pass to (only) scp',
      args: [
        Arg(
        name: 'SCP extra args'
      )
      ]
    ),
    Option(
      name: '--sftp-extra-args',
      description: 'Extra arguments to pass to (only) sftp',
      args: [
        Arg(
        name: 'SFTP extra args'
      )
      ]
    ),
    Option(
      name: '-ssh-extra-args',
      description: 'Extra arguments to pass to (only) ssh',
      args: [
        Arg(
        name: 'SSH extra args'
      )
      ]
    ),
    Option(
      name: '--ssh-common-args',
      description: 'Extra arguments to pass to sftp/scp/ssh',
      args: [
        Arg(
        name: 'SSH common args'
      )
      ]
    ),
    Option(
      name: ['--timeout', '-T'],
      description: 'Override the connection timeout in seconds',
      args: [
        Arg(
        name: 'timeout'
      )
      ]
    ),
    Option(
      name: ['--connection', '-c'],
      description: 'Connection type to use',
      args: [
        Arg(
        name: 'connection type'
      )
      ]
    ),
    Option(
      name: ['--ask-pass', '-k'],
      description: 'Ask for connection password'
    ),
    Option(
      name: ['--user', '-u'],
      description: 'Connect as this user',
      args: [
        Arg(
        name: 'user'
      )
      ]
    )
  ]
);