Skip to main content

unfrustrating python CLI

Project description

Sometimes I just want to execute a python callback and pass args/kwargs on the CLI, and not have to define any custom CLI entry point of any sort, nor change any code, typically when automating stuff, cli2 unfrustrates me:

cli2 yourmodule.yourcallback somearg somekwarg=foo

Sometimes I just want to define a new command and expose all callables in a module and I can’t just do it with a one-liner. cli2 unfrustrates me again:

console_script = cli2.ConsoleScript(__doc__).add_module('mymodule')
# then i add console_script entrypoint as such: mycmd = mycmd.console_script

I also like when readonly commands are in green, writing commands in yellow and destructive commands in red, I find the commands list in the help output more readable, and directive for new users of the CLI:

@cli2.config(color=cli2.RED)
def challenge(dir):
   '''The challenge command dares you to run it.'''
   os.exec('rm -rf ' + dir)

Of course then there’s all this code I need to have coverage for and I’m still so lazy that I still don’t write most of my test code myself, so I throwed an autotest function in cli2 (“ala” dbunit with a personal touch) that I can use as such:

@pytest.mark.parametrize('name,command', [
    ('cli2', ''),
    ('help', 'help'),
    ('help_debug', 'help debug'),
    # ... bunch of other commands
    ('debug', 'debug cli2.run to see=how -it --parses=me'),
])
def test_cli2(name, command):
    cli2.autotest(
        f'tests/{name}.txt',
        'cli2 ' + command,
    )

You should be able tho pip install cli2 and start using the cli2 command, or cli2.ConsoleScript to make your own commands.

https://asciinema.org/a/221137.svg

Check djcli, another cli built on cli2.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cli2-1.0.11.dev1.tar.gz (9.9 kB view details)

Uploaded Source

File details

Details for the file cli2-1.0.11.dev1.tar.gz.

File metadata

  • Download URL: cli2-1.0.11.dev1.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8

File hashes

Hashes for cli2-1.0.11.dev1.tar.gz
Algorithm Hash digest
SHA256 3247eab8f831d12aecd7763282800f0a69b5c285e32ce118060b802754cd0f55
MD5 170d3f0aeb70eaa76dd8cbf7fd16ae29
BLAKE2b-256 79c9dadafc6704ce61abd8b27e1771f022ca7945af223f023398bbbc082b2e78

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page