これは、Ubuntu Online、Fedora Online、Windows オンライン エミュレーター、または MAC OS オンライン エミュレーターなどの複数の無料オンライン ワークステーションの XNUMX つを使用して、OnWorks 無料ホスティング プロバイダーで実行できるコマンド genhtml です。
プログラム：
NAME
genhtml - LCOV カバレッジ データ ファイルから HTML ビューを生成します
SYNOPSIS
genhtml [-h| - 助けて] [-v|- バージョン]
[-q|- 静かな] [-s|- 詳細を表示] [-f|-フレーム]
[-b|--ベースラインファイル] ベースラインファイル
[-o|- 出力ディレクトリ 出力ディレクトリ]
[-t|- 題名 タイトル]
[-d|--説明ファイル 説明ファイル]
[-k|--keep-説明] [-c|--css ファイル cssファイル]
[-p|--prefix 接頭辞] [--プレフィックスなし]
[-ソースなし] [--スペース数 NUM] [--ハイライト]
[- 伝説] [--html-プロローグ プロローグファイル]
[--html-エピローグ エピローグファイル] [--html 拡張子 ]
[--html-gzip] [- 選別] [-並べ替えなし]
[--機能カバレッジ] [--機能範囲なし]
[--ブランチカバレッジ] [--ブランチカバレッジなし]
[--デマングル-cpp] [-無視-エラー エラー]
[--config-ファイル 設定ファイル] [--rc キーワード=値]
[- 精度 NUM]
トレースファイル
DESCRIPTION
次の場所にあるカバレッジ データの HTML ビューを作成します。 トレースファイル。 ご了承ください トレースファイル かもしれない
ファイル名のリスト。
HTML 出力ファイルは、現在の作業ディレクトリに作成されます。
--output-directory オプションが使用されます。 もしも トレースファイル 「.gz」で終わる場合は、
GZIP 圧縮されており、gunzip ツールを使用して透過的に解凍されます。
すべてのソース コード ファイルが存在し、正確なファイル システムで読み取れる必要があることに注意してください。
コンパイルされた場所。
オプションを使用 --css ファイル 生成された HTML 出力のレイアウトと色を変更します。 ファイルは
関連するカバレッジ率に応じて異なる色でマークされます。 デフォルトでは、
低、中、高カバレッジのカバレッジ制限は 0 ～ 75%、75 ～ 90%、および 90 ～ 100% に設定されます。
それぞれパーセント。 これらの値を変更するには、構成ファイルのオプションを使用します
genhtml_hi_limit genhtml_med_limit.
また、パーセンテージを表示する場合、0% と 100% は値が次の場合にのみ出力されることにも注意してください。
はそれぞれ正確に 0% と 100% です。 従来であれば四捨五入されるその他の値
0% または 100% までは、代わりに最も近い非境界値として出力されます。 この動作は次のとおりです
のそれに応じて gcov（1）ツール。
OPTIONS
-h
- 助けて
短いヘルプテキストを印刷して、終了します。
-v
- バージョン
バージョン番号を出力して終了します。
-q
- 静かな
進行状況メッセージを印刷しないでください。
すべての情報の進行状況の出力を抑制します。 このスイッチが有効になっている場合のみ
エラーまたは警告メッセージが出力されます。
-f
-フレーム
ソース コード ビューには HTML フレームを使用します。
有効にすると、ソース コード ファイルごとにフレームセットが作成され、概要が提供されます。
ソースコードを「クリック可能な」画像として表示します。 このオプションは速度が低下することに注意してください
ソースコードの各文字を検査する必要があるため、出力の作成が著しく困難になります
一度。 このオプションを使用するには、GD.pm Perl モジュールをインストールする必要があることにも注意してください。
作品（から入手できます） http://www.cpan.org).
-s
- 詳細を表示
詳細なディレクトリ ビューを生成します。
このオプションを有効にすると、 genhtml 各ファイル ビューの XNUMX つのバージョンを生成します。 一
標準情報と「詳細」バージョンへのリンクが含まれています。 後者
さらに、どのテスト ケースが何行をカバーしたかに関する情報が含まれています。
各ソースファイル。
-b ベースラインファイル
--ベースラインファイル ベースラインファイル
データを使用する ベースラインファイル カバレッジのベースラインとして。
で指定されたトレースファイル ベースラインファイル が読み取られ、すべてのカウントが見つかります。
オリジナル トレースファイル の対応するカウントによって減分されます。 ベースラインファイル
出力を作成する前に。
特定の行をカウントするとき、 ベースラインファイル より大きい
で数えます トレースファイル、結果はゼロです。
-o 出力ディレクトリ
- 出力ディレクトリ 出力ディレクトリ
ファイルを作成する 出力ディレクトリ。
このオプションを使用して伝える genhtml 結果のファイルを他のディレクトリに書き込みます
現在のものよりも。 もしも 出力ディレクトリ 存在しない場合は作成されます。
プロジェクトのサイズによっては、多くの作業が必要となるため、このオプションを使用することをお勧めします。
ファイルとサブディレクトリが作成される場合があります。
-t タイトル
- 題名 タイトル
ディスプレイ タイトル すべてのページのヘッダーにあります。
タイトル 生成された各 HTML ページのヘッダー部分に書き込まれ、
特定の出力が作成されたコンテキスト。 デフォルトでは、これは次の名前です
トレースファイル。
-d 説明ファイル
--説明ファイル 説明ファイル
テスト ケースの説明を読む 説明ファイル.
すべてのテスト ケースの説明は次の場所にあります 説明ファイル 入力で参照されています
データ ファイルは追加ページに読み取られ、追加ページに書き込まれます。
HTML出力。
ファイル形式は、 説明ファイル 次のとおりです。
各テストケースについて:
TN:
TD:
有効なテスト ケース名は、文字、数字、アンダースコア文字で構成できます。
('_')。
-k
--keep-説明
未使用のテストの説明は削除しないでください。
カバレッジ データが次のことを示している場合でも、説明ファイル内の説明を保持します。
関連するテスト ケースがコード行をカバーしていないこと。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_keep_descriptions.
-c cssファイル
--css ファイル cssファイル
外部スタイルシートファイルを使用する cssファイル.
このオプションを使用すると、追加の .css ファイルを指定して、
デフォルトのもの。 これは、デフォルトの色が目を飛び立たせたくなる場合に役立つかもしれません。
彼らのソケットから:)
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_css_file.
-p 接頭辞
--prefix 接頭辞
削除します 接頭辞 すべてのディレクトリ名から。
長いファイル名を含むリストは読みにくいため、次のような仕組みがあります。
上のすべてのディレクトリ名を自動的に短縮しようとする実装
共通のプレフィックスで始まる概要ページ。 デフォルトでは、これは
適用されると最小化されるプレフィックスを見つけようとするアルゴリズム
すべてのディレクトリ名の文字の合計結果。
このオプションを使用して、自分で削除するプレフィックスを指定します。
--プレフィックスなし
ディレクトリ名からプレフィックスを削除しないでください。
このスイッチは、前に説明したプレフィックス メカニズムを完全に無効にします。
のセクションから無料でダウンロードできます。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_no_prefix.
-ソースなし
ソースコードビューを作成しないでください。
ファイルごとにソース コード ビューを取得したくない場合は、このスイッチを使用します。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_no_source.
--スペース数 スペース
ソースビューのタブを次のように置き換えます NUM スペース
デフォルト値は8です。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_num_spaces.
--ハイライト
変換のみのカバレッジ データを含む行を強調表示します。
このオプションは、次の --diff オプションと組み合わせて使用します。 lcov それらを強調するために
以前から変換されたデータセットでのみカバーされていた行
ソースコードのバージョン。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_highlight.
- 伝説
HTML 出力に色の凡例を含めます。
このオプションを使用して、色分けの意味を説明する凡例を含めます。
結果として得られる HTML 出力。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_legend.
--html-プロローグ プロローグファイル
カスタマイズされた HTML プロローグを読む プロローグファイル.
このオプションを使用して、デフォルトの HTML プロローグ (HTML の最初の部分) を置き換えます。
に至るまでの、およびそれを含むソース コードタグ）の内容を含む
プロローグファイル。 プロローグ テキスト内では、次の単語が置き換えられます。
ページが生成されます:
@ページタイトル@
ページのタイトル。
@basedir@
ベース ディレクトリへの相対パス (CSS ファイルの検索など)。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_html_プロローグ.
--html-エピローグ エピローグファイル
カスタマイズされた HTML エピローグを読む エピローグファイル.
このオプションを使用して、デフォルトの HTML エピローグ (HTML の最後の部分) を置き換えます。
ソースを含む）の内容で エピローグファイル.
エピローグ テキスト内では、ページが更新されると次の単語が置き換えられます。
生成される:
@basedir@
ベース ディレクトリへの相対パス (CSS ファイルの検索など)。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_html_epilog.
--html 拡張子
生成された HTML ページには、カスタマイズされたファイル名拡張子を使用します。
このオプションは、ファイル名拡張子が異なる場合に便利です。
結果のページを正しくレンダリングするために必要です (php など)。 「.」に注意してください。 意思
ファイル名とこのオプションで指定された拡張子の間に挿入されます。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_html_extension.
--html-gzip
生成されたすべての HTML ファイルを gzip で圧縮し、指定した .htaccess ファイルを追加します。
ルート出力ディレクトリ内の gzip エンコーディング。
Web サーバーのスペースを節約したい場合は、このオプションを使用してください。 ウェブサーバーが必要です
.htaccess サポートと gzip 圧縮 HTML をサポートするブラウザ。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_html_gzip.
- 選別
-並べ替えなし
ファイルとディレクトリの概要の並べ替えられたビューを含めるかどうかを指定します。
並べ替えられたビューを含める場合は --sort を使用し、含めない場合は --no-sort を使用します。 並べ替えられたビュー
使用可能 デフォルトでは
並べ替えられたビューが有効になっている場合、各概要ページには次のビューへのリンクが含まれます。
そのページはカバー率順に並べ替えられています。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_sort.
--機能カバレッジ
--機能範囲なし
HTML 出力に関数カバレッジの概要を表示するかどうかを指定します。
--function-coverage を使用して関数カバレッジの概要を有効にするか、
--no-function-coverage を使用して無効にします。 機能範囲の概要は次のとおりです。 使用可能 by
デフォルト
機能カバレッジの概要が有効になっている場合、各概要ページには
ファイルまたはディレクトリごとに見つかってヒットした関数の数と、
結果として得られるカバー率。 さらに、各ソース コード ビューには、次へのリンクが含まれます。
そのファイル内にあるすべての関数とそれぞれの呼び出し数をリストするページ
それらの機能のために。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_function_coverage.
--ブランチカバレッジ
--ブランチカバレッジなし
HTML出力にブランチカバレッジデータを表示するかどうかを指定します。
ブランチ カバレッジの表示を有効にするには --branch-coverage を使用し、ブランチ カバレッジの表示を有効にするには --no-branch-coverage を使用します。
それを無効にします。 ブランチカバレッジデータ表示は 使用可能 初期設定で
ブランチ カバレッジ表示が有効になっている場合、各概要ページには番号が表示されます。
ファイルまたはディレクトリごとに見つかってヒットしたブランチの数とその結果
カバー率。 さらに、各ソース コード ビューには追加の列が含まれます。
これは、行のすべての分岐を、その分岐が行われたかどうかを示す情報とともにリストします。
か否か。 ブランチは次の形式で表示されます。
' + ': 少なくとも XNUMX 回は分岐が行われました
' - ': 分岐は行われませんでした
' # ': 分岐を含む基本ブロックは実行されませんでした
ブランチを対応するブランチに関連付けることが常に可能であるとは限らないことに注意してください。
ソース コード ステートメント: コンパイル中に、GCC はブランチをシャッフルする可能性があります。
より良いコードを生成するには、それらの一部を削除します。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_branch_coverage.
--デマングル-cpp
C++ 関数名をデマングルするかどうかを指定します。
C++ の内部関数名を人間の名前に変換する場合は、このオプションを使用します。
HTML 関数の概要ページに表示するための読みやすい形式。 このオプション
c++filt ツールがインストールされている必要があります (「 C ++フィルト（1））。
-無視-エラー エラー
エラーのリストを指定してから、処理を続行します。
このオプションを使用して、エラーのXNUMXつ以上のクラスのリストを指定します。
geninfoは、中止するのではなく、処理を続行する必要があります。
エラー 次のキーワードのコンマ区切りリストにすることができます。
ソース： データセットのソースコードファイルが見つかりませんでした。
--config-ファイル 設定ファイル
使用する構成ファイルを指定します。
このオプションを指定すると、システム全体の構成ファイルも
/ etc / lcovrc、またはユーザーごとの構成ファイル 〜/ .lcovrc 読み取られます。
このオプションは、次の複数のインスタンスを実行する必要がある場合に役立つことがあります。 genhtml
異なる構成ファイルオプションを並行して使用します。
--rc キーワード=値
構成ディレクティブをオーバーライドします。
このオプションを使用して、 キーワード=値 をオーバーライドするステートメント
lcovrc構成ファイル内の対応する構成ステートメント。 あなたはできる
複数の構成ステートメントをオーバーライドするには、このオプションを複数回指定してください。
詳細はこちら： lcovrc（5）使用可能なキーワードとその意味のリスト。
- 精度 NUM
カバレッジ率を表示するには NUM 小数点以下の桁数。
デフォルト値は1です。
このオプションは、構成ファイル オプションを使用して永続的に構成することもできます。
genhtml_precision.
onworks.net サービスを使用してオンラインで genhtml を使用する
