example python

example.py

#!/usr/bin/env python
'''
mymodule.py

what the module does
'''

import sys
import argparse

def run_me():
    print "I do stuff"

def main(args):
    '''
    This program does stuff
    '''
    if args.run_me:
        run_me()
    return 0 #no problems

if __name__ == '__main__':
    parser = argparse.ArgumentParser(description=main.__doc__) # Now my program has the same description as the doc string of main, handy!
    parser.add_argument('-r', '--run-me', action='store_true')

    args = parser.parse_args()
    sys.exit(main(args))