As mentioned in the docs the optparse.OptionParser uses an IndentedHelpFormatter to output the formatted option help, for which which I found some API
optparse.OptionParser
IndentedHelpFormatter
Try taking a look at argparse. Documentation says it supports position arguments and nicer looking help messages.