2012-03-25 2 views
3

Я хотел бы интегрировать документацию проекта Java/Android в экземпляр Trac. Поскольку Trac написан на Python, мне нужен способ извлечения комментариев JavaDoc из Python.Извлечь JavaDoc с Python

Может ли кто-нибудь дать мне несколько советов, как это сделать? Я думал об этих двух возможностях, но я не знаю, есть ли библиотеки, которые могут это сделать:

  • Разбор всего источника Java.
  • Пусть JavaDoc сделать работу и как-то извлечь документы с его выхода
+0

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

+0

Мне бы хотелось, чтобы какая-то более тесная интеграция в Trac понравилась, например, просматривая документы или легко ссылаясь на нее из вики/билетов и т. Д. – Julian

ответ

2

Я придумал следующее решение: я нашел что-то под названием json-doclet, которое является своего рода Плагин для Javadoc, который выводит JSON, с которым должно быть удобно работать.

+0

Не забудьте принять ваш ответ! – Taymon

0

Doxygen, который написан на C++, можно разобрать Javadoc и output it as XML. Вы могли бы назвать это из Python, а затем преобразовать XML в любой формат, который вам нравится. (Это будет более эффективно, если вы сделаете это на C++, используя doxmlparser, но вы также можете сделать это в Python.)

+0

Возможно, это сработало, но, к сожалению, Javadoc и Doxygen не разделяют точно такой же синтаксис. – Julian

Смежные вопросы