сфинкс-apidoc не находит все файлы питон

Question

У меня есть следующий два класса:

class Test1(): 
    """Test1()""" 

    def fn_test1(): 
     """fn_test1 """ 
     print "Hello1" 

.

class Test2(): 
    """Test2()""" 

    def fn_test2(): 
     """fn_test2 """ 
     print "Hello2" 

Этих классов хранятся в разных папках, которые показаны ниже:

$ tree -A 
. 
├── docs 
│ ├── _build 
│ ├── conf.py 
│ ├── index.rst 
│ ├── make.bat 
│ ├── Makefile 
│ ├── _static 
│ ├── _templates 
│ └── Test1.rst 
└── src 
    └── standard 
     ├── test1 
     │ └── Test1.py 
     └── test2 
      └── Test2.py 

Я попытался запустить сфинкс-apidoc, но находит только Test1.rst с помощью следующей команды:

$ sphinx-apidoc -f -A "Author" -H "Test project" -V "version 1.0" -R "release 2014" -F -d 4 -e -P -o docs /home/u/tmp/sphinx/src/standard/* 
Creating file docs/Test1.rst. 
Creating file docs/conf.py. 
Creating file docs/index.rst. 
Creating file docs/Makefile. 
Creating file docs/make.bat. 

Если удалить * он находит ничего:

$ sphinx-apidoc -f -A "Author" -H "Test project" -V "version 1.0" -R "release 2014" -F -d 4 -e -P -o docs /home/u/tmp/sphinx/src/standard/ 
Creating file docs/conf.py. 
Creating file docs/index.rst. 
Creating file docs/Makefile. 
Creating file docs/make.bat. 

Как можно вызвать sphinx-apidoc, чтобы он нашел Test1.py и Test2.py?

Answer 1

Упаковка Python зависит от дерева каталогов. Итак, из того, что вы сделали, стандарт представляет собой пакет с двумя «подпакетами», test1 и test2. Каждая подпапка содержит модуль, либо Test1, либо Test2.

Вы должны добавить (возможно) пустой файл с именем __init__.py для каждого каталога, содержащего пакет и запустить

sphinx-apidoc -f -A "Author" -H "Test project" -V "version 1.0" -R "release 2014" -F -d 4 -e -P -o docs /home/u/tmp/sphinx/src/standard/ 

без знака *.