epydoc AttributeError： 'Text'オブジェクトに 'data'属性がありません

Question

私は過去2年間にepydocを使用していませんでしたが、私のクラスとメソッドをほとんど手間をかけずに追跡することができました。

今日は最新のバージョン3.0.1をインストールしましたが、このエラーが発生し、解決策が提供されていないようです。

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' 

epydocプロジェクトは停止していますか？

Answer 1

Epydocが長時間維持されておらず、最後のリリースは現在Pytonとのdocutilsと非常に互換性がありません。 。しかし、これはまだ有用なツールですが、パッチを当てる必要があります。

Python 2.7コードのドキュメントをビルドするために私がEpydocで使用したパッチは以下の通りです：http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/epydoc/（それらはPLD-Linux Epydocパッケージの一部です）。

私は、誰かがコードを引き継ぎ、開発を継続例外が発生することができなかったように...

Answer 2

私は、epydocトラッカーにパッチを見つけ、それはこの部分が問題を解決し、とにかく時代遅れだった：

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

オブジェクトがnull（すなわちなし）に対してテストすることができることを願います。

if object is None: