Example usage of the new begin.formatters module to preserve whitespace from docstrings in help output.

rawhelp.py

import begin
my_formatter = begin.formatters.compose(begin.formatters.RawDescription)

@begin.subcommand
def sub():
    """Such    text
                Very whitespace
            So exact
    """

@begin.start(formatter_class=my_formatter)
def main():
    """Plain text formatting for this help:
    - how does it look?
    Params:
        foo is yummy... 
    """

rawhelp.py -h

usage: rawhelp.py [-h] {sub} ...

Plain text formatting for this help:
    - how does it look?
    Params:
        foo is yummy... 
    

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

Available subcommands:
  {sub}
    sub       Such text

rawhelp.py sub -h

usage: rawhelp.py sub [-h]

Such    text
                Very whitespace
            So exact
    

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