Refactor/doc tests

[neomonkeus]

@niftools/pyffi-reviewer

Overview

Convert remaining text based doctests to run using nose.

Fixes Known Issues

N\A

Documentation

Covered by existing documentation

Testing

All existing test cases passing

Manual

N\A pure automation

Automated

Full regression suite passing

Additional Information

[coveralls]

Coverage decreased (-0.4%) to 57.881% when pulling b8d7ea3 on neomonkeus:refactor/doc_tests into f2789ea on niftools:develop.

[neomonkeus]

Travis automation has picked up issues with python 3.7 and some generator functions.
Need to investigate if there is a backwards compatible update that will support 3.4 - 3.7

[TagnumElite]

I figured out the problem, my solution was this. Or surround the next() with try-catch StopIteration clause

Example:

def get_triangles(self):
    """Generator for all triangles."""
        if self.faces: ...
        elif self.indices_data:
        it = iter(self.indices_data.indices)
        try:
            while True:
                yield next(it), next(it), next(it)
        except StopIteration:
            pass