Автоматически генерировать вывод doctest с расширением Sphinx

Кажется, я что-то упустил в расширении sphinx для doctest.

Типичный пример в документации::

.. doctest::

   >>> print 1
   1

Нет ли способа позволить sphinx автоматически генерировать вывод (здесь :1)?

Насколько я понял, можно запустить :

$ make doctest

, что позволит протестировать фрагменты кода и сравнить реальный результат с ожидаемым. Например, если у вас есть

.. doctest::

   >>> print 1
   3

, doctest предупредит вас, что он получил 1, а ожидал 3.

Вместо этого я хотел бы, чтобы sphinx вставлял только реальный вывод в мою строку документации или в мой файл.rst. Например, если у нас есть что-то вроде :

.. doctest::

    >>> print 1
    >>> print [2*x for x in range(3)]

, мне бы хотелось, чтобы при запуске make doctestс параметром строка документации менялась на :

.. doctest::

   >>> print 1
   1
   >>> print [2*x for x in range(3)]
   [0,2,4]

. Я уверен, что это возможно и было бы очень удобно!

8
задан Rik Poggi 21 March 2012 в 17:31
поделиться