epydoc AttributeError: Obiekt "Tekst" nie ma atrybutu "dane"

Question

Nie używam epidoka w ciągu ostatnich 2 lat, ale bardzo mi się przydało, aby śledzić moje zajęcia i metody przy niewielkim wysiłku.

Dzisiaj zainstalowałem najnowszą wersję 3.0.1, ale dostaję ten błąd, a wyszukiwanie w pobliżu wydaje się nie zapewniać żadnych rozwiązań.

Traceback (most recent call last):-] Parsing docstrings: pyramid.reques... 
    File "/home/neurino/apps/env/bin/epydoc", line 13, in <module> 
    cli() 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/epydoc/cli.py", line 965, in cli 
    main(options, names) 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/epydoc/cli.py", line 757, in main 
    exclude_parse=exclude_parse) 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/epydoc/docbuilder.py", line 275, in build_doc_index 
    parse_docstring(val_doc, docindex, suppress_warnings) 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/epydoc/docstringparser.py", line 265, in parse_docstring 
    api_doc.summary, api_doc.other_docs = api_doc.descr.summary() 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/epydoc/markup/restructuredtext.py", line 179, in summary 
    try: self._document.walk(visitor) 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/docutils/nodes.py", line 137, in walk 
    if child.walk(visitor): 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/docutils/nodes.py", line 129, in walk 
    visitor.dispatch_visit(self) 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/docutils/nodes.py", line 1604, in dispatch_visit 
    return method(node) 
    File "/home/neurino/apps/env/lib/python2.7/site-packages/epydoc/markup/restructuredtext.py", line 307, in visit_paragraph 
    m = self._SUMMARY_RE.match(child.data) 
AttributeError: 'Text' object has no attribute 'data' 

Czy projekt epocentrum nie działa?

Answer 1

Epydoc nie została utrzymana przez długi czas, a ostatnia wersja nie jest całkiem zgodny z aktualnym pyton i docutils . Wciąż jest to przydatne narzędzie, ale wymaga kilku poprawek.

Oto kilka poprawek, których użyłem z Epydoc do budowania dokumentacji dla mojego kodu Python 2.7: http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/epydoc/ (są one częścią pakietu PLD-Linux Epydoc).

Życzę ktoś przejmuje kodu oraz dalszy rozwój ...

Answer 2

znalazłem poprawkę na epydoc tracker, to był przestarzały i tak ta część rozwiązuje problem:

markup/restructuredtext.py 
307c307,310 
<     m = self._SUMMARY_RE.match(child.data) 
--- 
>     try: 
>      m = self._SUMMARY_RE.match(child.data) 
>     except AttributeError: 
>      m = None 

Answer 3

Obiekty mogą być testowane na wartości null (tj Brak), tak aby nie mogły być wystąpił wyjątek.