2012-03-25 14 views
3

Ich möchte die Dokumentation eines Java-/Android-Projekts in eine Trac-Instanz integrieren. Da Trac in Python geschrieben ist, brauche ich eine Möglichkeit, die JavaDoc-Kommentare aus Python zu extrahieren.JavaDoc mit Python extrahieren

Kann mir jemand Hinweise geben, wie ich das erreichen kann? Ich habe gedacht dieser beiden Möglichkeiten, aber ich weiß nicht, ob es alle Bibliotheken, die dies tun können:

  • Analysieren Sie die gesamte Java-Quelle.
  • Let JavaDoc die Arbeit machen und extrahieren irgendwie die Dokumentation von seinem Ausgang
+0

Zu welchem ​​Zweck benötigen Sie welche Teile der Dokumentation? Es könnte einfacher sein, das generierte JavaDoc als statische Dateien auf Ihrem Hosting-Server zu verwenden. –

+0

Ich hätte gerne eine engere Integration in Trac, wie zum Beispiel die Docs durchsuchen oder einfach aus dem Wiki/Tickets etc. referenzieren. – Julian

Antwort

2

Ich kam mit der folgenden Lösung: Ich habe etwas namens json-doclet gefunden, die Art von a ist Plugin für Javadoc, das ein JSON ausgibt, mit dem relativ einfach zu arbeiten ist.

+0

Denken Sie daran, Ihre Antwort zu akzeptieren! – Taymon

0

Doxygen, die in C++ geschrieben ist, kann Javadoc und output it as XML analysieren. Sie könnten es von Python aus aufrufen und dann das XML in ein beliebiges Format umwandeln. (Dies wird effizienter sein, wenn Sie es in C++ mit dem doxmlparser tun, aber Sie können es auch in Python tun.)

+0

Das würde wahrscheinlich funktionieren, aber leider teilen Javadoc und Doxygen nicht genau die gleiche Syntax. – Julian