Authentication needed for help command

[Andreas Jaeger]

I can run just fine:
$ openstack --version
openstack 1.0.0

but this fails:
$ openstack help aggregate
ERROR: openstack Authentication type must be selected with --os-auth-type

$ openstack help
ERROR: openstack Authentication type must be selected with --os-auth-type

[Terry Howe (thowe-g)]

Since the commands available depend on your service catalog, OSC cannot produce help without authenticating. The command set is loaded dynamically. This is not a bug.

[Andreas Jaeger (jaegerandi)]

How can we then document the client best in an automatic way? With 0.4.1 it worked just fine, see here for the result:

http://docs.openstack.org/cli-reference/content/openstackclient_commands.html

[Steve Martinelli (stevemar)]

You can use `openstack --help` for a list of commands.

[Steve Martinelli (stevemar)]

Commands based on the default APIs that are selected by OSC...

[Christian Berendt (berendt)]

I think python-openstackclient should behave like the other CLI
clients. I think the different behavior of python-openstackclient will
confuse a lot of user when trying to get help.

While it is true that it is possible to get a list of all available
commands with 'openstack --help' (our requirement) it is not possible to
get detailled information of a command or subcommand without setting the
auth parameters.

[Dean Troyer (dtroyer)]

The current behaviour is broken, and I think I did it when adding the auth plugin support. Our intention is for a certain amount of help to always be available. The limitation will be with regard to API versions, but for any set of versions the help text should always be displayed without any authentication configured.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/159940

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/159940
Committed: https://git.openstack.org/cgit/openstack/python-openstackclient/commit/?id=505fa14cd68e13d066a5770a229ba0d7fa88d2a9
Submitter: Jenkins
Branch: master

commit 505fa14cd68e13d066a5770a229ba0d7fa88d2a9
Author: Dean Troyer <email address hidden>
Date: Fri Feb 27 09:19:12 2015 -0600

    Fix auth-required for help command

    When we got picky with the auth arguments we broke using help without
    any auth config supplied. This rearranges things a bit to do the argument
    checking when the deferred auth request to Identity occurs so commands
    that do not need auth have a chance to live short but useful lives.

    Closes-Bug: #1399588
    Change-Id: I8ceac491cf65e25eddb62ab2713f471fe686756d