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:
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 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,
)
This got me to 86% coverage in 3 minutes. How so ?
Well, it will execute the command and compare with the contents in the test text file with GNU or busybox diff and fail if there’s a diff. If the file doesn’t exist then it will create it and fail because it created the fixture. I can just rm -rf my tests dir and run pytest again, and use git diff to see what has changed.
You should be able tho pip install cli2 and start using the cli2 command, or cli2.ConsoleScript to make your own commands.
Projects using cli2 so far:
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
File details
Details for the file cli2-0.2.1.dev1.tar.gz.
File metadata
- Download URL: cli2-0.2.1.dev1.tar.gz
- Upload date:
- Size: 7.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.29.1 CPython/3.6.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a3d2a85f2ac7736e481f2861a5682233ec459a0e949ce547d05ae3155b694af3 |
|
| MD5 | e8ed798510e5e5b1ebcb56f40fe491b5 |
|
| BLAKE2b-256 | 7dd74e379c88c0d07b883fcab0dc92e979847519c22e9ddd29c7bad419cfffdf |
