5

Sphinx を使用して python ドキュメントを生成しようとしています。問題は、sphinx-build が最終的にモジュールを実行したり、グローバル スコープで何かを評価したりすることです。これを行う理由はありますか?そして、これを無効にするために設定できるフラグを知っている人はいますか?

Sphinx はコード カバレッジまたは同等の機能を実行しようとしているようですが、これは私がやりたいことではありません。通常、これは問題にはなりませんが、特定のモジュール セットは環境に固有のものです。

4

1 に答える 1

6

autodoc プラグインはモジュールをインポートし、モジュールをインポートするとグローバル スコープのすべてが評価されるため、Sphinx はグローバル スコープのすべてを評価します。

これを停止するには、次のいずれかを行います。

  • autodoc プラグインを無効にする ( autodocsphinx 構成ファイルで検索)、または
  • 実行したくないコードを次のようなものでガードしますif __name__ == "__main__": do_stuff()
于 2012-06-13T00:11:35.780 に答える