support -h ?

[pallets]

support -h ?

[lra]

Also too much info might be counterproductive, but mentioning the default help option might help here?

[douglarek]

@lra maybe since -h does not follow the UNIX command line conventions.

read this: http://click.pocoo.org/why/

[mitsuhiko]

-h is commonly used as different argument. --help is the standard way to invoke the help page of a script.

[untitaker]

Maybe make it configurable? Most commands have -h show the help.

[douglarek]

@untitaker If you really want to have -h, you can do it as below:

import click

def print_help(ctx, value):
    if not value:
        return
    print ctx.format_help()
    ctx.exit()

@click.command()
@click.option('-h', is_flag=True, callback=print_help, expose_value=False,
        is_eager=True, help='Show this message and exit.')
def hello():
    pass


if __name__ == '__main__':
    hello()

[untitaker]

OTOH that seems like fighting or working around the framework.

[douglarek]

@untitaker Not so serious, it is Click's very cool feature: http://click.pocoo.org/options/#callbacks-and-eager-options.

[lra]

Is there any place we can read about this unix command line convention? I'm curious and would also like to apply it to my programs.