Sphinx doesn't find Python packages when using autodoc

Question

I'm trying to create documentation for test Python project before doing it for the real project. My system : Win7 64 bit, python 2.7.5 64 bit. My project name is testDoc. It includes python pakage, named t, which includes 2 modules t1 and t2 and `__init__.py`. `__init__.py` contains: ``` import t1 import t2 ``` t1.py contains: ``` ''' Created on 27 2013 @author: ''' class MyClass(object): ''' Hi ''' def __init__(self,selfparams): ''' Constructor ''' pass ``` To create docs I run in the command line in testDoc: ``` sphinx-apidoc -A "me" -F -o docs . ``` Sphinx creates many files and it's ok according to Sphinx docs. Then, conf.py is modified ``` sys.path.insert(0, os.path.abspath(absolute path to testDoc)) ``` I enter docs folder and type ``` make html ``` and get the following erroneous output: ``` Making output directory... Running Sphinx v1.1.3 loading pickled environment... not yet created building [html]: targets for 2 source files that are out of date updating environment: 2 adde…

Accepted Answer

I don't know what the "absolute path to testDoc" is, but from the Sphinx output I can see that the `testDoc` directory structure is `testDoc/t/docs`. The `docs` directory is where `conf.py` is.

For the module search path to be set up properly, you need to go two levels up from `conf.py`:

```
sys.path.insert(0, os.path.abspath("../.."))
```

Sphinx doesn't find Python packages when using autodoc

Solution

Problem