sphinx.ext.coverage -- ドキュメントのカバレッジの状況を収集します

この拡張機能には CoverageBuilder という追加のビルダーが一つ含まれます。

class sphinx.ext.coverage.CoverageBuilder[ソース]

To use this builder, activate the coverage extension in your configuration file and give -M coverage on the command line.

課題

このセクションを書くこと

ビルダーがチェックすべきものを決定するための、いくつかの設定値も追加されます:

coverage_ignore_modules
coverage_ignore_functions
coverage_ignore_classes
coverage_ignore_pyobjects

Python正規表現 のリスト。

これらの正規表現のいずれかがPythonオブジェクトのインポートフルパスのいずれかの部分と一致する場合、そのPythonオブジェクトはドキュメントカバレッジのレポートから除外されます。

バージョン 2.1 で追加.

coverage_c_path
coverage_c_regexes
coverage_ignore_c_items
coverage_write_headline

もし False が設定されると、ヘッドラインを出力しなくなります。

バージョン 1.1 で追加.

coverage_skip_undoc_in_source

docstringが書かれておらず、ソースにドキュメントがないオブジェクトはスキップします。デフォルトは False です。

バージョン 1.1 で追加.

coverage_show_missing_items

欠落しているオブジェクトも標準出力に出力します。デフォルトでは False です。

バージョン 3.1 で追加.

coverage_statistics_to_report

Print a tabular report of the coverage statistics to the coverage report. True by default.

Example output:

+-----------------------+----------+--------------+
| Module                | Coverage | Undocumented |
+=======================+==========+==============+
| package.foo_module    | 100.00%  | 0            |
+-----------------------+----------+--------------+
| package.bar_module    | 83.33%   | 1            |
+-----------------------+----------+--------------+

バージョン 7.2 で追加.

coverage_statistics_to_stdout

Print a tabular report of the coverage statistics to standard output. False by default.

Example output:

+-----------------------+----------+--------------+
| Module                | Coverage | Undocumented |
+=======================+==========+==============+
| package.foo_module    | 100.00%  | 0            |
+-----------------------+----------+--------------+
| package.bar_module    | 83.33%   | 1            |
+-----------------------+----------+--------------+

バージョン 7.2 で追加.