Мы используем make html для создания HTML-документов из документов .rst и нашего кода Python с помощью Sphinx. Мы также включили расширение sphinx.ext.doctest в Sphinx, чтобы можно было тестировать любые примеры кода в нашей документации, запустив make doctest. Если вы сделаете это:
вы увидите, что в doctest есть много флагов, например, -f для быстрого завершения тестов, а не для запуска всех тестов; и возможность тестировать только именованные файлы, а не все из них. Но
как передать эти флаги в doctest при запуске make doctest? Во время отладки новых образцов кода мне бы очень хотелось, чтобы doctest проверял только один файл, который я отлаживаю, и терпел неудачу, как только обнаруживал первую ошибку. Однако, например, делая такие вещи:
не работает; doctest по-прежнему сообщает о нескольких ошибках, а не о первой найденной.
Подробнее здесь:
https://stackoverflow.com/questions/791 ... rom-sphinx