DockerCLI/e2e/cli-plugins/testdata/docker-help-helloworld.golden


Usage:	docker helloworld [OPTIONS] COMMAND

A basic Hello World plugin for tests

Options:
      --who string   Who are we addressing? (default "World")

Commands:
  apiversion  Print the API version of the server
  goodbye     Say Goodbye instead of Hello

Run 'docker helloworld COMMAND --help' for more information on a command.
Integrate CLI plugins with `docker help «foo»` Signed-off-by: Ian Campbell <ijc@docker.com> 2018-12-11 09:52:59 -05:00
Ignore unknown arguments on the top-level command. This allows passing argument to plugins, otherwise they are caught by the parse loop, since cobra does not know about each plugin at this stage (to avoid having to always scan for all plugins) this means that e.g. `docker plugin --foo` would accumulate `plugin` as an arg to the `docker` command, then choke on the unknown `--foo`. This allows unknown global args only, unknown arguments on subcommands (e.g. `docker ps --foo`) are still correctly caught. Add an e2e test covering this case. Signed-off-by: Ian Campbell <ijc@docker.com> 2019-01-17 08:38:38 -05:00			`Usage: docker helloworld [OPTIONS] COMMAND`
Integrate CLI plugins with `docker help «foo»` Signed-off-by: Ian Campbell <ijc@docker.com> 2018-12-11 09:52:59 -05:00
			`A basic Hello World plugin for tests`

Ignore unknown arguments on the top-level command. This allows passing argument to plugins, otherwise they are caught by the parse loop, since cobra does not know about each plugin at this stage (to avoid having to always scan for all plugins) this means that e.g. `docker plugin --foo` would accumulate `plugin` as an arg to the `docker` command, then choke on the unknown `--foo`. This allows unknown global args only, unknown arguments on subcommands (e.g. `docker ps --foo`) are still correctly caught. Add an e2e test covering this case. Signed-off-by: Ian Campbell <ijc@docker.com> 2019-01-17 08:38:38 -05:00			`Options:`
			`--who string Who are we addressing? (default "World")`

Integrate CLI plugins with `docker help «foo»` Signed-off-by: Ian Campbell <ijc@docker.com> 2018-12-11 09:52:59 -05:00			`Commands:`
Allow plugins to make use of the cobra `PersistentPreRun` hooks. Previously a plugin which used these hooks would overwrite the top-level plugin command's use of this hook, resulting in the dockerCli object not being fully initialised. Provide a function which plugins can use to chain to the required behaviour. This required some fairly ugly arrangements to preserve state (which was previously in-scope in `newPluginCOmmand`) to be used by the new function. Signed-off-by: Ian Campbell <ijc@docker.com> 2018-12-17 10:55:38 -05:00			`apiversion Print the API version of the server`
Integrate CLI plugins with `docker help «foo»` Signed-off-by: Ian Campbell <ijc@docker.com> 2018-12-11 09:52:59 -05:00			`goodbye Say Goodbye instead of Hello`

			`Run 'docker helloworld COMMAND --help' for more information on a command.`