Skip to main content

python cli scripts for humans

Project description

Easy python cli scripts for people that just want get things done.

Captain was lovingly crafted for First Opinion.


A valid captain cli script needs two things:

  1. a shebang on the first line

    #!/usr/bin/env python
  2. a main function

    def main(foo, bar):
        return 0

That’s it! Whatever arguments you define in the main function will be options on the command line.

def main(foo, bar):
    return 0

So foo and bar can be called on the command line:

$ pyc path/to/ --foo=1 --bar=2

Argument Decorator

The captain.decorators.arg() decorator provides a nice passthrough api to the full argparse module if you need to really customize how arguments are passed into your script:

#!/usr/bin/env python

from captain import echo
from captain.decorators import arg

@arg('--foo', '-f')
@arg('arg', metavar='ARG')
def main(**kwargs):
    '''this is the help description'''
    print kwargs['foo'], kwargs['a']
    return 0

Would print a help string like this:

usage: [-h] [--foo FOO] ARG

this is the help description

positional arguments:

optional arguments:
  -h, --help         show this help message and exit
  --foo FOO, -f FOO


This small module makes it easy to print output in your script while still giving you full control by being able to configure the logger if you need to. It also will obey the global --quiet flag.

from captain import echo

var1 = "print"

var2 = "stdout"
echo.out("this will {} to {}", var1, var2)

var2 = "stderr"
echo.err("this will {} to {}", var1, var2)

e = ValueError("this will print with stacktrace and everything")


A typical standard python cli script:

import argparse

if __name__ == u'__main__':
    parser = argparse.ArgumentParser(description='fancy script description')
    parser.add_argument("--foo", action='store_true')
    parser.add_argument("--bar", default=0, type=int)
    parser.add_argument("args", nargs='*')
    args = parser.parse_args()

would become:

#!/usr/bin/env python

def main(foo=False, bar=0, *args):
    '''fancy script description'''
    return 0

You can get a list of all available scripts in a directory by running captain with no arguments:

$ captain


Use pip:

$ pip install captain




allow you to set *_arg values, so you could do arg=[int] to make sure the *args values where all ints, likewise, you could do foo_arg, bar_arg and that would be positional arg 0 and 1, I think this would work ok and be ok, we could also make everything that ends in _kwarg be a named argument and everything that ends in _arg be a positional argument. Then *args and **kwargs would just be for everything else (the catchall).

Project details

Download files

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

Files for captain, version 0.1.9
Filename, size File type Python version Upload date Hashes
Filename, size captain-0.1.9.tar.gz (7.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page