trove help create has positional arguments in incorrect spot

I think this bug is actually the way argparse handles the optional/positional arguments.

On the surface i do not see a way of fixing this bug. Here is the code in argparse that prints the usage.
http://hg.python.org/cpython/file/default/Lib/argparse.py#l314

datsun180b offered me this link: http://docs.python.org/2/library/argparse.html#formatter-class

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

To elaborate, this problem only surfaces if your command has positional argument(s) immediately after an optional argument that is a narg='*' (or any narg other than narg='?'). In the 'create' scenario, databases and users are both narg='*'.

The proposed fix formats the usage string such that the positional arguments precede the optional.

i.e. instead of:

usage: trove create <name> <flavor_id>
                    [--size <size>]
                    [--databases <databases> [<databases> ...]]
                    [--users <users> [<users> ...]] [--backup <backup>]
                    [--availability_zone <availability_zone>]

you get:

usage: trove create [--size <size>]
                    [--databases <databases> [<databases> ...]]
                    [--users <users> [<users> ...]] [--backup <backup>]
                    [--availability_zone <availability_zone>]
                    <name> <flavor_id>

doh!

I meant to say that you get:

usage: trove create <name> <flavor_id>
                    [--size <size>]
                    [--databases <databases> [<databases> ...]]
                    [--users <users> [<users> ...]] [--backup <backup>]
                    [--availability_zone <availability_zone>]

vs:

usage: trove create [--size <size>]
                    [--databases <databases> [<databases> ...]]
                    [--users <users> [<users> ...]] [--backup <backup>]
                    [--availability_zone <availability_zone>]
                    <name> <flavor_id>

Reviewed: https://review.openstack.org/53792
Committed: http://github.com/openstack/python-troveclient/commit/21a468dd3be820bcd83eb7b90b72f2ca48ad8530
Submitter: Jenkins
Branch: master

commit 21a468dd3be820bcd83eb7b90b72f2ca48ad8530
Author: amcrn <email address hidden>
Date: Fri Oct 25 00:12:01 2013 -0700

    Usage String has Positionals after Optionals

    print positionals before optionals in the usage string to help
    users avoid argparse nargs='*' problems.

    ex: 'trove create --databases <db_name> <name> <flavor_id>'
    fails with 'error: too few arguments', but this succeeds:
    'trove create <name> <flavor_id> --databases <db_name>'

    Change-Id: I400c9f0ca5580bd287c5f3bcf935352e88071bc8
    Closes-Bug: #1243981