python - epydoc は python ファイルを実行します

Question

複数のクラスを含む python ファイルがあり、epydoc を使用してコメントからドキュメントを作成したいと考えていました。だから私は私のDebian wheezyシステムのコンソールで行います:

epydoc --html storage_config_tool.py -o ~/

常に Python アプリケーションを実行し、ドキュメントの生成は 21% で停止します。epydocgui を使用した場合と同じ動作です。

単純な hello world プログラムでテストすると、すべて正常に動作します。ファイルが 1000 行を超えているため、投稿できません。プログラム自体は正常に動作します。

なぜそれが起こるのですか？まだ見つかっていませんが、間違ったフォーマットが問題になる可能性があります。

Thx 4 ヘルプ

Answer 1

コードを見なければ、何が問題なのかを判断するのは困難です。ただし、アプリケーションを起動するコードがステートメントで保護されていないように聞こえるため、ファイルをインポートするif __name__ == '__main__':とアプリケーションが実行されます。epydoc役立つかもしれない2つのこと：

1. モジュールのインポート時に、、および代入文storage_config_tool.pyのみが実行されるように修正します。classdef

2. epydoc --html --parse-only storage_config_tool.py -o ~/ドキュメントの生成に使用します。これにより、完全なドキュメントを生成するために必要な場合とそうでない場合があるモジュールのインポート手順がスキップされます。