@tcstewar: that's starting to get kinda complicated.

Could we just let the Python exception be thrown, and have a part of the documentation (preferably both the docstring and the `docs` folder) note/describe the exception? Even if we do find a good fix for this in the code, I still think that we should have a part of the documentation for common exceptions and errors.