conf.py imports the version from the local module, so it needs to have the
directory in the python path, otherwise it fails with:
$ sphinx-apidoc -f -e -o docs/api azure/datalake/store
Creating file docs/api/store.core.rst.
Creating file docs/api/store.enums.rst.
Creating file docs/api/store.exceptions.rst.
Creating file docs/api/store.lib.rst.
Creating file docs/api/store.multiprocessor.rst.
Creating file docs/api/store.multithread.rst.
Creating file docs/api/store.retry.rst.
Creating file docs/api/store.transfer.rst.
Creating file docs/api/store.utils.rst.
Creating file docs/api/store.rst.
Creating file docs/api/modules.rst.
$ make -C docs man
make: Entering directory '/home/bluca/git/azure-data-lake-store-python/docs'
sphinx-build -b man -d build/doctrees source build/man
Running Sphinx v1.8.4
Configuration error:
There is a programmable error in your configuration file:
Traceback (most recent call last):
File "/usr/lib/python3/dist-packages/sphinx/config.py", line 368, in eval_config_file
execfile_(filename, namespace)
File "/usr/lib/python3/dist-packages/sphinx/util/pycompat.py", line 150, in execfile_
exec_(code, _globals)
File "/home/bluca/git/azure-data-lake-store-python/docs/source/conf.py", line 65, in <module>
import azure.datalake.store
ModuleNotFoundError: No module named 'azure.datalake'
make: *** [Makefile:156: man] Error 2
make: Leaving directory '/home/bluca/git/azure-data-lake-store-python/docs'
4098effc65