Hi, nice job.

One suggestion for docs, include one minimal Python API Example, the best example that I found is this, that isn't so simple since command has lot of params.

[]'s
Hugo

$ sudo pip2.7 install texthon
Downloading/unpacking texthon
  Running setup.py egg_info for package texthon
    Traceback (most recent call last):
      File "<string>", line 16, in <module>
      File "/tmp/pip-build-root/texthon/setup.py", line 3, in <module>
        with open('README.rst') as file:
    IOError: [Errno 2] No such file or directory: 'README.rst'
    Complete output from command python setup.py egg_info:
    Traceback (most recent call last):

  File "<string>", line 16, in <module>

  File "/tmp/pip-build-root/texthon/setup.py", line 3, in <module>

    with open('README.rst') as file:

IOError: [Errno 2] No such file or directory: 'README.rst'

Python 2.7 on Linux 3.2.

The current $> slurp syntax is handy but it has some shortcomings:

1. Usually, it's more convenient to strip trailing whitespace by default at the end of a template and to let the call site set the correct combination of whitespace and newlines.
2. When a template ends with a compound directive there is no way to strip trailing whitespace, as $> won't work after #}. This can be done at the call site, but this is not possible for main as it's never explicitly called.

Stripping trailing whitespace by default won't be backward compatible, so I propose two simple changes:

1. To add a configuration option to strip template trailing whitespace by default.
2. To allow $> after #}.