Rustテストのインサイト

Tuistはcargo testからの個々のテスト結果（ユニットテスト、統合テスト、doctestを含む）を報告します。Rustの依存関係や追加のテストランナーは不要です。

テスト実行を報告する#

miseのCargoラッパーが構成されていれば、引き続きcargo testと入力できます。Cargoは通常どおり引数、出力、終了コードを使用してテストをコンパイル・実行します。レポートの失敗がテストの結果に影響することはありません。

通常どおりパッケージを選択したり、テストをフィルタリングできます。

Tuistが追跡する項目#

• 完了したテストスイートからの合格・不合格・無視されたテスト。
• ユニットテスト、統合テスト、およびdoctest。
• スイート全体の所要時間。
• 利用可能なブランチ、コミット、CI、およびランナーのメタデータ。

フィルタリングされたテストや失敗後に実行されなかったテストは、合格として報告されることはありません。結果はダッシュボードのテストに表示されます。

パッケージ、モジュール、およびテストケース#

TuistはCargoのパッケージとターゲットごとに結果をグループ化します。Rustのモジュールパスは、ターゲット内の個々のテストをグループ化します。

Doctestはstore::doctest/storeなどの別個のモジュールを使用します。名前にはソースの場所が含まれるため、例を移動するとその識別子が変更される可能性があります。

Doctestと所要時間#

Doctestは通常のテストコマンドで実行され、compile_fail、should_panic、およびno_runの例を含みます。Doctestのみを実行するには：

安定版のlibtestはスイート全体の時間を報告しますが、個々のテストの所要時間は報告しません。利用できないタイミング情報はケースごとの所要時間の履歴や分析から除外されますが、テストの結果は信頼性と実行回数に依然として反映されます。

レポートの制限#

個々の結果はCargo/libtestのデフォルト出力から収集されます。--no-run、--list、quietまたはCargoの詳細出力、代替フォーマット、キャプチャされていないテスト出力を使用するコマンドは、個々のテストレポートなしで通常どおり実行されます。カスタムハーネス、不完全なサマリー、曖昧なターゲットの帰属、 oversizedなレポートはアップロードされません。

ワークスペースのパッケージに同名の統合ターゲットがある場合は、-p <package>で1つを選択してください。レポートは正確なワークスペースパッケージ名をサポートします。依存パッケージ、バージョン限定セレクター、グロブは通常どおり実行されますが、レポートされません。絶対パスのdoctestパスは省略され、チェックアウトパスがテストの識別子に含まれないようにします。

Tuistは結果を収集しながら出力をストリーミングします。これにより自動カラー検出に影響を与える可能性があります。Cargo終了後も出力パイプを開いたままにするバックグラウンドプロセスがあると、レポートが省略される可能性がありますが、Cargoの終了ステータスは変更されません。

信頼性と選択#

flakyテストの検出と隔離を使用して不安定なテストを調査し、ミュートまたはスキップします。テストシャーディングはCIワーカー全体にCargoターゲットを分散します。カバレッジの取り込み、カバレッジベースのテスト選択、およびビルドワンスの配布は、通常のCargoテスト実行では利用できません。

トラブルシューティング#

テスト実行がダッシュボードに表示されない場合は、デバッグ出力を有効にしてレポートが送信されなかった理由を確認します。