питон doctest из отдельного файла + место

Question

У меня есть структура каталогов вроде этого:

|-root 
    |-app 
    program.py 
    tests.txt 
    |-tests 
    runTests.py 

Мой файл tests.txt содержит все doctests на моем program.py коде. Он называет

from program import * 

, а затем он вызывает все обращения к доктринам. Мой файл runTests.py имеет следующий код:

import doctest 
doctest.testfile("app/tests.txt") 

В командной строке я тогда называю:

python runTests.py 

и действительно найти файл tests.txt и читает его успешно, но это не делает найти модуль «программа», который я пытаюсь импортировать. Что я делаю не так? Как я могу использовать их в отдельных каталогах и все еще иметь возможность запускать тесты?

Благодаря

Answer 1

Там два способа сделать это:

1. Вы можете добавить его sys.path в runTests.py: import sys; sys.path.append('app')
   То же самое может быть достигнуто с помощью переменной среды PYTHONPATH.

2. Вы можете повернуть папку в пакет, добавив файл __init__.py и импортировав from app.program import * в tests.txt.

Напоминание: Основной предпосылкой doctest является то, что метод/функция документации (что вы получаете, когда вы смотрите на __doc__ собственности) объясняет, что он делает и дает примеры (тесты).

После этого Doctest находит такой код и выполняет его, убедившись, что примеры в документации фактически работают.

Если вы переместите тесты, то вы уберете главный источник информации от пользователя вашего кода. Я предполагаю, что это может иметь смысл, если у вас обширная документация за пределами исходного кода или если у вас много дополнительных тестов (вы хотите дать пользователям несколько примеров, а не все 500 модульных тестов, которые обеспечивают покрытие кода до 100%).

При этом, чтобы исправить проблему, вам необходимо сделать импортную работу. Папка app не волшебным образом появляется в пути поиска для модулей. Вы должны сказать Python, что на самом деле это место, где он должен выглядеть.