Unable to build API docs

[Juan Nunez-Iglesias]

Hi,

I've been battling with RTD for hours now trying to get it to build my package so that I can see the API (which is currently blank). I've finally got most of the problematic import errors gone (using your Mock class suggestion), but this last one has me stumped:

https://readthedocs.org/builds/gala/2382746/
"""
zip_safe flag not set; analyzing archive contents...

gala.test_package: module references __file__
"""

The code lives here:
https://github.com/janelia-flyem/gala

And the missing API documentation is here:
http://gala.readthedocs.org/en/latest/api/api.html

(clicking through to any of those sections shows an empty page.)

Is the exact build process documented somewhere? This would be a lot less painful if I could replicate it on my machine...

Any ideas? Thanks,

Juan.

[Juan Nunez-Iglesias]

It was clearly something to do with setup.py install, so I *finally* got the docs to build with this wonderful hack (tldr: when on RTD, replace "install" with "build_ext" "-i" on sys.argv). I'm happy to have the docs working but it doesn't feel like the "right" way to solve this, so suggestions are still very much welcome!