sphinx, buildbot (и покрытие кода). как они интегрируются? - PullRequest
3 голосов
/ 03 марта 2011

У меня не такой маленький пакет на python, с довольно большой историей, документированной с помощью строк документации.Во время его разработки мы представили buildbot , а затем Jenkins / Hudson .Недавно я добавил рецепт sphinx в свой buildbot.cfg, чтобы собирать документацию из источников и постоянно обновлять документы, доступные в Интернете.

пока все хорошо, каждый разЯ фиксирую изменение, Дженкинс тщательно проверяет пакет, генерирует очень полный обзор и обновляет наш сайт документации.

одно из расширений sphinx, которое я включил: охват , для охвата документацииотчет, который в настоящее время недокументирован.

Я выполняю sphinx в своей среде, сгенерированной buildbot, и мне не удается включить статистику покрытия на сайт документации, сгенерированный sphinx!

есть намеки?

1 Ответ

2 голосов
/ 03 марта 2011

, как указано на странице sphinx.ext.coverage , покрытие вычисляется, если указан строитель -b coverage.

результатом является файл "python.txt", файл ReST,Ваша задача - интегрировать ее в собственную документацию.

...