A simple command runner
Project description
A simple command runner that uses argparse under the hood.
Somewhat inspired by Invoke.
Python 3 only (3.3 and up).
License
MIT
Defining Commands
from runcommands import command
@command
def hello(config, name=None):
if name:
print('Hello,' name)
else:
print('Hello, World')
Listing Commands
> runcommands --list hello [--help] [-n NAME]
Running Commands
> runcommands hello Hello, World > runcommands hello -n You Hello, You
Configuration
Configuration is read from an INI file where the values are encoded as JSON. This allows for rich values without requiring third party libraries.
A config file looks like this, with sections for different environments:
; commands.cfg
[DEFAULT]
project_name = "My Project"
[dev]
debug = true
[stage]
debug = true
defaults.runcommands.runners.commands.remote.host = "stage_host"
[prod]
debug = false
remote.host = "prod_host"
defaults.runcommands.runners.commands.remote.host = "{remote.host}"
Accessing Config
When the above config file is read, its values can be accessed using item or attribute syntax. The following are equivalent:
>>> config.remote.host >>> config['remote']['host']
In some situations, it’s convenient to be able to get at config values using a special dotted notation:
>> key = 'remote.host'
>>> config._get_dotted(key)
>>> config._get_dotted('does not exist', default='some default')
Extending Config
A config file can extend another config file using the extends key. This example uses an “asset path” where the config file lives in a Python package named mypackage:
extends = "mypackage:my.cfg"
A relative or absolute file system can be specified instead:
extends = "/path/to/my.cfg"
Interpolation
Config values can contain Python format strings like {remote.host}. These will be replaced with the corresponding config values.
Default Option Values
As shown above, default option values can be specified for a command via configuration. These defaults will take precedence over option values defined on the command but can be overridden via command line options.
Features
Easy help for commands: runcommands hello --help
Global config is built in: runcommands --env staging deploy ... (no default envs are built in though; these must be defined as needed)
Default env and command options can be defined in a config file
TODO
Add command line completion
Add more documentation and examples
Write tests
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.
