=====================================
 Tests in example form - pure python
=====================================

This file contains doctest examples embedded as code blocks, using normal
Python prompts.  See the accompanying file for similar examples using IPython
prompts (you can't mix both types within one file). The following will be run
as a test::

    >>> 1+1
    2
    >>> print ("hello")
    hello

More than one example works::

    >>> s="Hello World"

    >>> s.upper()
    'HELLO WORLD'

but you should note that the *entire* test file is considered to be a single
test.  Individual code blocks that fail are printed separately as ``example
failures``, but the whole file is still counted and reported as one test.