7

過去 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 プロジェクトは終了していますか?

4

3 に答える 3

6

Epydoc は長い間メンテナンスされておらず、最後のリリースは現在の Pyton および docutils と完全に互換性がありません。ただし、それでも便利なツールですが、パッチを適用する必要があります。

Python 2.7 コードのドキュメントを作成するために Epydoc で使用したパッチを次に示します: http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/epydoc/ (これらは PLD-Linux Epydoc パッケージ)。

誰かがコードを引き継いで開発を続けてくれたらいいのに…</p>

于 2011-07-15T11:07:12.430 に答える
0

例外が発生しないように、オブジェクトを null (つまり None) に対してテストできます。

if object is None:
于 2016-01-02T20:41:51.687 に答える