TestReport

TestReport["file"]

ファイルから検定結果のレポートを与える.

TestReport[{test1,test2,}]

testiの結果のレポートを与える.

TestReport[{report1,report2,}]

すべての検定レポート reportiを統合して一つにまとめたレポートを与える.

詳細とオプション

  • TestReportTestReportObjectを返す.
  • TestReportは,テキスト形式のWolfram言語ファイルと検定ノートブックフレームワークを使うノートブックの両方を扱うことができる.
  • TestReportは結果が"NotEvaluated"の検定だけを実行し,すでに評価されたものは飛ばす.
  • TestReportには次のオプションを使うことができる.
  • HandlerFunctions <||>生成されたイベントの扱い方
    HandlerFunctionsKeysAutomaticハンドラ関数に渡すパラメータ
    MemoryConstraint Infinity各検定が使えるメモリ(単位:バイト)
    ProgressReporting $ProgressReporting進捗レポートをするかどうか
    SameTest SameQ実際の出力と期待される出力を比較する関数
    TestEvaluationFunction TestEvaluate作成された検定を評価する関数
    TimeConstraint Infinity各検定が使える時間(単位:秒)
  • TestReport[File["file"]]もサポートされている.
  • TestReportの実行中に以下のイベントが生成できる.
  • "FileStarted"検定ファイルの開始
    "FileCompleted"検定ファイルの完了
    "ReportStarted"検定レポートの開始
    "ReportCompleted"検定レポートの完了
    "RuntimeFailure"ランタイムエラーの発生
    "TestCreated"検定が作成された
    "TestEvaluated"検定が評価された
  • HandlerFunctions-><|,"eventi"->fi,|>という指定のときは,eventiが生成されるたびにfi[assoc]が評価される.The elements of assoc の要素はHandlerFunctionsKeysの設定によって指定されたキーを持つ.
  • 次は,HandlerFunctionsKeysで指定可能なキーである.
  • "EventName"処理されるイベントの名前
    "EventID"イベントの一意的ID
    "Failure"イベントに関連付けられた失敗オブジェクト
    "FailureType"検定に関連付けられた失敗のタイプ
    "Outcome"検定に関連付けられた成果物
    "TestFileName"イベントに関連付けられた検定ファイルの名前
    "TestObject"イベントに関連付けられた検定オブジェクト
    "Title"検定レポートの名前
  • TestReportは検定が実行されているファイル名に$TestFileNameを設定する.
  • CreateNotebook["Testing"]はTesting Notebookフレームワークで使用するために設定された空白のノートブックを開く.

例題

すべて開くすべて閉じる

  (2)

TestObjectのリストを実行する:

ノートブックから検定を実行する:

失敗した検定についての情報を抽出し,TabViewに表示する:

既存のTestReportObjectを新たなものと統合する:

スコープ  (1)

基本的な用法  (1)

検定リストを実行する:

TestReportObjectの特性:

個々の検定結果のリスト:

検定の期待される出力と実際の出力が異なる箇所を比較する:

オプション  (10)

HandlerFunctions  (1)

HandlerFunctionsを使ってTestReportの実行中に発生した検定イベントを記録する:

特別なキー"UnhandledEvent"を使ってすべてのイベントを記録する:

HandlerFunctionKeys  (1)

HandlerFunctionsKeysを使ってHandlerFunctionsの使用中に興味があるキーだけを選ぶ:

イベントの中に要求するキーを与えないものがある場合,そのイベントはAssociationには現れない:

MemoryConstraint  (2)

各検定にメモリ制約を適用する:

特定のTestCreateのオプションはTestReportレベルで設定されたオプションを無効にする:

ProgressReporting  (1)

実行に時間がかかる検定の場合は,進捗レポートが自動的に表示される:

オプションProgressReportingを使ってこれを無効にする:

進捗レポートを大域的に無効にしたければ,$ProgressReportingを無効にするとよい:

SameTest  (2)

指定されたすべての検定にSameTestを適用する:

特定のTestCreateのオプションは,TestReportレベルで設定されたオプションを無効にする:

TestEvaluationFunction  (1)

ノートブックにあるすべての検定を評価せずに出力する:

ノートブックにあるすべての検定を評価前に出力し,その後評価する:

TimeConstraint  (2)

指定されたすべての検定に時間制約を適用する:

特定のTestCreateのオプションは,TestReportレベルで設定されたオプションを無効にする:

アプリケーション  (1)

個々の検定のリストを実行し,同時にファイルを検定する:

TestReportを再び使って既存のTestReportObjectを新たなものと統合する:

複数のTestReportObjectTestReportを使って統合する際,複製された検定はレポートから自動的に削除される:

特性"ResultsByTestFileName" を使って同じファイルで実行された検定をグループ化することができる:

特性と関係  (2)

ThrowCatchHandlerFunctionsで使って検定が失敗したときにテストランの実行を中止する:

ThrowCatchTestEvaluationFunctionで使うこともできる:

ReapSowHandlerFunctionsで使ってすべてのイベント名を収集する:

考えられる問題  (2)

成功であると考えられる検定がないTestReport

TestReportは,一意のテストを1回実行して収集する:

同じテストを複数回実行する場合は,テストを複数回作成しなければならない:

Wolfram Research (2014), TestReport, Wolfram言語関数, https://reference.wolfram.com/language/ref/TestReport.html (2023年に更新).

テキスト

Wolfram Research (2014), TestReport, Wolfram言語関数, https://reference.wolfram.com/language/ref/TestReport.html (2023年に更新).

CMS

Wolfram Language. 2014. "TestReport." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2023. https://reference.wolfram.com/language/ref/TestReport.html.

APA

Wolfram Language. (2014). TestReport. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TestReport.html

BibTeX

@misc{reference.wolfram_2024_testreport, author="Wolfram Research", title="{TestReport}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/TestReport.html}", note=[Accessed: 17-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_testreport, organization={Wolfram Research}, title={TestReport}, year={2023}, url={https://reference.wolfram.com/language/ref/TestReport.html}, note=[Accessed: 17-November-2024 ]}