Как установить параметр по умолчанию как -h для щелчка Python?

Как установить параметр по умолчанию как -h для щелчка Python?

По умолчанию мой скрипт ничего не показывает, если аргументы duh.py не указаны:

import click


CONTEXT_SETTINGS = dict(help_option_names=['-h', '--help'])

@click.command(context_settings=CONTEXT_SETTINGS)
@click.option('--toduhornot', is_flag=True, help='prints "duh..."')
def duh(toduhornot):
    if toduhornot:
        click.echo('duh...')

if __name__ == '__main__':
    duh()

[вне]:

$ python3 test_click.py -h
Usage: test_click.py [OPTIONS]

Options:
  --toduhornot  prints "duh..."
  -h, --help    Show this message and exit.



$ python3 test_click.py --toduhornot
duh...


$ python3 test_click.py 

Вопрос:

Как показано выше, по умолчанию информация не печатается python3 test_click.py.

Есть ли способ, чтобы для параметра по умолчанию было установлено значение -h, если аргументы не указаны, например.

$ python3 test_click.py 
Usage: test_click.py [OPTIONS]

Options:
  --toduhornot  prints "duh..."
  -h, --help    Show this message and exit.

person alvas    schedule 21.05.2018    source источник
comment
Итак, если никаких вариантов не указано, то вы хотите помочь по умолчанию? Вы сказали: если аргументы не указаны, но в вашем примере определяется только параметр, он не определяет никаких аргументов.   -  person Stephen Rauch    schedule 22.05.2018


Ответы (4)


Если вы наследуете от click.Command и переопределяете метод parse_args(), вы можете создать собственный класс по умолчанию, чтобы помочь, например:

Пользовательский класс

import click

class DefaultHelp(click.Command):
    def __init__(self, *args, **kwargs):
        context_settings = kwargs.setdefault('context_settings', {})
        if 'help_option_names' not in context_settings:
            context_settings['help_option_names'] = ['-h', '--help']
        self.help_flag = context_settings['help_option_names'][0]
        super(DefaultHelp, self).__init__(*args, **kwargs)

    def parse_args(self, ctx, args):
        if not args:
            args = [self.help_flag]
        return super(DefaultHelp, self).parse_args(ctx, args)

Использование пользовательского класса:

Чтобы использовать пользовательский класс, передайте параметр cls декоратору @click.command(), например:

@click.command(cls=DefaultHelp)

Как это работает?

Это работает, потому что click — это хорошо спроектированная объектно-ориентированная среда. Декоратор @click.command() обычно создает экземпляр объекта click.Command, но позволяет переопределить это поведение с помощью параметра cls. Таким образом, относительно легко наследоваться от click.Command в нашем собственном классе и переопределять нужные методы.

В этом случае мы переопределяем click.Command.parse_args() и проверяем наличие пустого списка аргументов. Если он пуст, то мы вызываем справку. Кроме того, этот класс по умолчанию будет использовать справку ['-h', '--help'], если не указано иное.

Тестовый код:

@click.command(cls=DefaultHelp)
@click.option('--toduhornot', is_flag=True, help='prints "duh..."')
def duh(toduhornot):
    if toduhornot:
        click.echo('duh...')

if __name__ == "__main__":
    commands = (
        '--toduhornot',
        '',
        '--help',
        '-h',
    )

    import sys, time

    time.sleep(1)
    print('Click Version: {}'.format(click.__version__))
    print('Python Version: {}'.format(sys.version))
    for cmd in commands:
        try:
            time.sleep(0.1)
            print('-----------')
            print('> ' + cmd)
            time.sleep(0.1)
            duh(cmd.split())

        except BaseException as exc:
            if str(exc) != '0' and \
                    not isinstance(exc, (click.ClickException, SystemExit)):
                raise

Полученные результаты:

Click Version: 6.7
Python Version: 3.6.3 (v3.6.3:2c5fed8, Oct  3 2017, 18:11:49) [MSC v.1900 64 bit (AMD64)]
-----------
> --toduhornot
duh...
-----------
> 
Usage: test.py [OPTIONS]

Options:
  --toduhornot  prints "duh..."
  -h, --help    Show this message and exit.
-----------
> --help
Usage: test.py [OPTIONS]

Options:
  --toduhornot  prints "duh..."
  -h, --help    Show this message and exit.
-----------
> -h
Usage: test.py [OPTIONS]

Options:
  --toduhornot  prints "duh..."
  -h, --help    Show this message and exit.
person Stephen Rauch    schedule 23.05.2018

Начиная с версии 7.1 можно просто указать @click.command(no_args_is_help=True) .

person ofornes    schedule 24.08.2020
comment
Однозначно правильный метод. - person David Medinets; 11.05.2021

Ваша структура не рекомендуется, вы должны использовать:

import click


CONTEXT_SETTINGS = dict(help_option_names=['-h', '--help'])


@click.group(context_settings=CONTEXT_SETTINGS)
def cli():
    pass


@cli.command(help='prints "duh..."')
def duh():
    click.echo('duh...')

if __name__ == '__main__':
    cli()

А затем python test_click.py напечатает справочное сообщение:

Usage: test_click.py [OPTIONS] COMMAND [ARGS]...

Options:
  -h, --help  Show this message and exit.

Commands:
  duh  prints "duh..."

Таким образом, вы можете использовать python test_click.py duh для вызова duh.

Обновлять

import click


CONTEXT_SETTINGS = dict(help_option_names=['-h', '--help'])

@click.command(context_settings=CONTEXT_SETTINGS)
@click.option('--toduhornot', is_flag=True, help='prints "duh..."')
def duh(toduhornot):
    if toduhornot:
        click.echo('duh...')
    else:
        with click.Context(duh) as ctx:
            click.echo(ctx.get_help())

if __name__ == '__main__':
    duh()
person Sraw    schedule 21.05.2018
comment
Хммм, но это накладывает команду duh, и когда я делаю python test_click.py duh, она все равно не выводит справочное сообщение =( - person alvas; 22.05.2018
comment
Могу я также проверить if *args == None? - person alvas; 23.05.2018

Самый простой подход, который я нашел

import click

@click.command()
@click.option('--option')
@click.pass_context

def run(ctx, option):
    if not option:
        click.echo(ctx.get_help())
        ctx.exit()
person nucky    schedule 22.11.2019
comment
Идеальный! Как раз то, что я хотел. Все остальное было очень запутанным. - person wulftone; 19.03.2020