.NET テスト

dd-trace ci run --help

namespace Datadog.Trace.Ci
{
    /// <summary>
    /// CI Visibility テストモジュール
    /// </summary>
    public sealed class TestModule
    {
        /// <summary>
        /// テストフレームワークを取得します
        /// </summary>
        public string? Framework { get; }
        /// <summary>
        /// モジュール名を取得します
        /// </summary>
        public string Name { get; }
        /// <summary>
        /// テストモジュールの開始日を取得します
        /// </summary>
        public System.DateTimeOffset StartTime { get; }
        /// <summary>
        /// テストモジュールを閉じます
        /// </summary>
        /// <remarks>可能な限り CloseAsync() バージョンを使用します。</remarks>
        public void Close() { }
        /// <summary>
        /// テストモジュールを閉じます
        /// </summary>
        /// <remarks>可能な限り CloseAsync() バージョンを使用します。</remarks>
        /// <param name="duration">テストモジュールの期間</param>
        public void Close(System.TimeSpan? duration) { }
        /// <summary>
        /// テストモジュールを閉じます
        /// </summary>
        /// <returns>タスクインスタンス </returns>
        public System.Threading.Tasks.Task CloseAsync() { }
        /// <summary>
        /// テストモジュールを閉じます
        /// </summary>
        /// <param name="duration">テストモジュールの期間</param>
        /// <returns>タスクインスタンス </returns>
        public System.Threading.Tasks.Task CloseAsync(System.TimeSpan? duration) { }
        /// <summary>
        /// このセッションのために新しいテストスイートを作成します
        /// </summary>
        /// <param name="name">テストスイートの名前</param>
        /// <returns>テストスイートインスタンス</returns>
        public Datadog.Trace.Ci.TestSuite GetOrCreateSuite(string name) { }
        /// <summary>
        /// このセッションのために新しいテストスイートを作成します
        /// </summary>
        /// <param name="name">テストスイートの名前</param>
        /// <param name="startDate">テストスイートの開始日</param>
        /// <returns>テストスイートインスタンス</returns>
        public Datadog.Trace.Ci.TestSuite GetOrCreateSuite(string name, System.DateTimeOffset? startDate) { }
        /// <summary>
        /// 例外からエラー情報を設定します
        /// </summary>
        /// <param name="exception">例外インスタンス</param>
        public void SetErrorInfo(System.Exception exception) { }
        /// <summary>
        /// エラー情報を設定します
        /// </summary>
        /// <param name="type">エラータイプ</param>
        /// <param name="message">エラーメッセージ</param>
        /// <param name="callStack">エラーのコールスタック</param>
        public void SetErrorInfo(string type, string message, string? callStack) { }
        /// <summary>
        /// 数字タグをテストに設定します
        /// </summary>
        /// <param name="key">タグのキー</param>
        /// <param name="value">タグの値</param>
        public void SetTag(string key, double? value) { }
        /// <summary>
        /// 文字列タグをテストに設定します
        /// </summary>
        /// <param name="key">タグのキー</param>
        /// <param name="value">タグの値</param>
        public void SetTag(string key, string? value) { }
        /// <summary>
        /// 新しいテストモジュールを作成します
        /// </summary>
        /// <param name="name">テストモジュール名</param>
        /// <returns>新しいテストモジュールインスタンス</returns>
        public static Datadog.Trace.Ci.TestModule Create(string name) { }
        /// <summary>
        /// 新しいテストモジュールを作成します
        /// </summary>
        /// <param name="name">テストモジュール名</param>
        /// <param name="framework">テスティングフレームワーク名</param>
        /// <param name="frameworkVersion">テスティングフレームワークのバージョン</param>
        /// <returns>新しいテストモジュールインスタンス</returns>
        public static Datadog.Trace.Ci.TestModule Create(string name, string framework, string frameworkVersion) { }
        /// <summary>
        /// 新しいテストモジュールを作成します
        /// </summary>
        /// <param name="name">テストモジュール名</param>
        /// <param name="framework">テスティングフレームワーク名</param>
        /// <param name="frameworkVersion">テスティングフレームワークのバージョン</param>
        /// <param name="startDate">テストセッション開始日</param>
        /// <returns>新しいテストモジュールインスタンス</returns>
        public static Datadog.Trace.Ci.TestModule Create(string name, string framework, string frameworkVersion, System.DateTimeOffset startDate) { }
    }

    /// <summary>
    /// CI Visibility テストスイート
    /// </summary>
    public sealed class TestSuite
    {
        /// <summary>
        /// このスイートのテストモジュールを取得します
        /// </summary>
        public Datadog.Trace.Ci.TestModule Module { get; }
        /// <summary>
        /// テストスイート名を取得します
        /// </summary>
        public string Name { get; }
        /// <summary>
        /// テストスイートの開始日を取得します
        /// </summary>
        public System.DateTimeOffset StartTime { get; }
        /// <summary>
        /// テストスイートを閉じます
        /// </summary>
        public void Close() { }
        /// <summary>
        /// テストスイートを閉じます
        /// </summary>
        /// <param name="duration">テストスイートの所要時間</param>
        public void Close(System.TimeSpan? duration) { }
        /// <summary>
        /// このスイートの新しいテストを作成します
        /// </summary>
        /// <param name="name">テスト名</param>
        /// <returns>テストインスタンス</returns>
        public Datadog.Trace.Ci.Test CreateTest(string name) { }
        /// <summary>
        /// このスイートの新しいテストを作成します
        /// </summary>
        /// <param name="name">テストの名前</param>
        /// <param name="startDate">テスト開始日</param>
        /// <returns>テストインスタンス</returns>
        public Datadog.Trace.Ci.Test CreateTest(string name, System.DateTimeOffset startDate) { }
        /// <summary>
        /// 例外からエラー情報を設定します
        /// </summary>
        /// <param name="exception">例外インスタンス</param>
        public void SetErrorInfo(System.Exception exception) { }
        /// <summary>
        /// エラー情報を設定します
        /// </summary>
        /// <param name="type">エラータイプ</param>
        /// <param name="message">エラーメッセージ</param>
        /// <param name="callStack">エラーのコールスタック</param>
        public void SetErrorInfo(string type, string message, string? callStack) { }
        /// <summary>
        /// 数字タグをテストに設定します
        /// </summary>
        /// <param name="key">タグのキー</param>
        /// <param name="value">タグの値</param>
        public void SetTag(string key, double? value) { }
        /// <summary>
        /// 文字列タグをテストに設定します
        /// </summary>
        /// <param name="key">タグのキー</param>
        /// <param name="value">タグの値</param>
        public void SetTag(string key, string? value) { }
    }

    /// <summary>
    /// CI Visibility テスト
    /// </summary>
    public sealed class Test
    {
        /// <summary>
        /// テスト名を取得します
        /// </summary>
        public string? Name { get; }
        /// <summary>
        /// テスト開始日を取得します
        /// </summary>
        public System.DateTimeOffset StartTime { get; }
        /// <summary>
        /// このテストのテストスイートを取得します
        /// </summary>
        public Datadog.Trace.Ci.TestSuite Suite { get; }
        /// <summary>
        /// ベンチマークデータを追加します
        /// </summary>
        /// <param name="measureType">メジャータイプ</param>
        /// <param name="info">メジャー情報</param>
        /// <param name="statistics">統計値</param>
        public void AddBenchmarkData(Datadog.Trace.Ci.BenchmarkMeasureType measureType, string info, in Datadog.Trace.Ci.BenchmarkDiscreteStats statistics) { }
        /// <summary>
        /// テストを閉じます
        /// </summary>
        /// <param name="status">テストステータス</param>
        public void Close(Datadog.Trace.Ci.TestStatus status) { }
        /// <summary>
        /// テストを閉じます
        /// </summary>
        /// <param name="status">テストステータス</param>
        /// <param name="duration">テストスイートの期間</param>
        public void Close(Datadog.Trace.Ci.TestStatus status, System.TimeSpan? duration) { }
        /// <summary>
        /// テストを閉じます
        /// </summary>
        /// <param name="status">テストステータス</param>
        /// <param name="duration">テストスイートの期間</param>
        /// <param name="skipReason">この場合 </param>
        public void Close(Datadog.Trace.Ci.TestStatus status, System.TimeSpan? duration, string? skipReason) { }
        /// <summary>
        /// ベンチマークのメタデータを設定します
        /// </summary>
        /// <param name="hostInfo">ホスト情報</param>
        /// <param name="jobInfo">ジョブ情報</param>
        public void SetBenchmarkMetadata(in Datadog.Trace.Ci.BenchmarkHostInfo hostInfo, in Datadog.Trace.Ci.BenchmarkJobInfo jobInfo) { }
        /// <summary>
        /// 例外からエラー情報を設定します
        /// </summary>
        /// <param name="exception">例外インスタンス</param>
        public void SetErrorInfo(System.Exception exception) { }
        /// <summary>
        /// エラー情報を設定します
        /// </summary>
        /// <param name="type">エラータイプ</param>
        /// <param name="message">エラーメッセージ</param>
        /// <param name="callStack">エラーのコールスタック</param>
        public void SetErrorInfo(string type, string message, string? callStack) { }
        /// <summary>
        /// テストパラメーターを設定します
        /// </summary>
        /// <param name="parameters">TestParameters インスタンス</param>
        public void SetParameters(Datadog.Trace.Ci.TestParameters parameters) { }
        /// <summary>
        /// 数字タグをテストに設定します
        /// </summary>
        /// <param name="key">タグのキー</param>
        /// <param name="value">タグの値</param>
        public void SetTag(string key, double? value) { }
        /// <summary>
        /// 文字列タグをテストに設定します
        /// </summary>
        /// <param name="key">タグのキー</param>
        /// <param name="value">タグの値</param>
        public void SetTag(string key, string? value) { }
        /// <summary>
        /// テスト方法情報を設定します
        /// </summary>
        /// <param name="methodInfo">Test MethodInfo インスタンス</param>
        public void SetTestMethodInfo(System.Reflection.MethodInfo methodInfo) { }
        /// <summary>
        /// テストの特徴を設定します
        /// </summary>
        /// <param name="traits">特徴ディクショナリー</param>
        public void SetTraits(System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> traits) { }
    }

    /// <summary>
    /// テストステータス
    /// </summary>
    public enum TestStatus
    {
        /// <summary>
        /// パステストステータス
        /// </summary>
        Pass = 0,
        /// <summary>
        /// フェイルテストステータス
        /// </summary>
        Fail = 1,
        /// <summary>
        /// スキップテストステータス
        /// </summary>
        Skip = 2,
    }

    /// <summary>
    /// テストパラメーター
    /// </summary>
    public class TestParameters
    {
        /// <summary>
        /// テストの引数を取得または設定します
        /// </summary>
        public System.Collections.Generic.Dictionary<string, object>? Arguments { get; set; }
        /// <summary>
        /// テストパラメーターメタデータを取得または設定します
        /// </summary>
        public System.Collections.Generic.Dictionary<string, object>? Metadata { get; set; }
    }

    /// <summary>
    /// ベンチマーク測定の離散統計
    /// </summary>
    public readonly struct BenchmarkDiscreteStats
    {
        /// <summary>
        /// 尖度値
        /// </summary>
        public readonly double Kurtosis;
        /// <summary>
        /// 最大値
        /// </summary>
        public readonly double Max;
        /// <summary>
        /// 平均値
        /// </summary>
        public readonly double Mean;
        /// <summary>
        /// 中央値
        /// </summary>
        public readonly double Median;
        /// <summary>
        /// 最小値
        /// </summary>
        public readonly double Min;
        /// <summary>
        /// サンプル数
        /// </summary>
        public readonly int N;
        /// <summary>
        /// 90 パーセンタイル値
        /// </summary>
        public readonly double P90;
        /// <summary>
        /// 95 パーセンタイル値
        /// </summary>
        public readonly double P95;
        /// <summary>
        /// 99 パーセンタイル値
        /// </summary>
        public readonly double P99;
        /// <summary>
        /// 歪度値
        /// </summary>
        public readonly double Skewness;
        /// <summary>
        /// 標準偏差値
        /// </summary>
        public readonly double StandardDeviation;
        /// <summary>
        /// 標準エラー値
        /// </summary>
        public readonly double StandardError;
        /// <summary>
        /// <see cref="BenchmarkDiscreteStats"/> 構造体の新しいインスタンスを初期化します。
        /// </summary>
        /// <param name="n">サンプル数</param>
        /// <param name="max">最大値</param>
        /// <param name="min">最小値</param>
        /// <param name="mean">平均値</param>
        /// <param name="median">中央値</param>
        /// <param name="standardDeviation">標準偏差値</param>
        /// <param name="standardError">標準エラー値</param>
        /// <param name="kurtosis">尖度値</param>
        /// <param name="skewness">歪度値</param>
        /// <param name="p99">99 パーセンタイル値</param>
        /// <param name="p95">95 パーセンタイル値</param>
        /// <param name="p90">90 パーセンタイル値</param>
        public BenchmarkDiscreteStats(int n, double max, double min, double mean, double median, double standardDeviation, double standardError, double kurtosis, double skewness, double p99, double p95, double p90) { }
        /// <summary>
        /// double の配列からベンチマークの離散統計値を取得します
        /// </summary>
        /// <param name="values">double の配列</param>
        /// <returns>ベンチマーク離散統計インスタンス</returns>
        public static Datadog.Trace.Ci.BenchmarkDiscreteStats GetFrom(double[] values) { }
    }

    /// <summary>
    /// ベンチマークホスト情報
    /// </summary>
    public struct BenchmarkHostInfo
    {
        /// <summary>
        /// クロノメーター周波数
        /// </summary>
        public double? ChronometerFrequencyHertz;
        /// <summary>
        /// クロノメーター分解能
        /// </summary>
        public double? ChronometerResolution;
        /// <summary>
        ///  ロジカルコア数
        /// </summary>
        public int? LogicalCoreCount;
        /// <summary>
        /// OS バージョン
        /// </summary>
        public string? OsVersion;
        /// <summary>
        /// 物理コア数
        /// </summary>
        public int? PhysicalCoreCount;
        /// <summary>
        /// 物理プロセッサー数
        /// </summary>
        public int? ProcessorCount;
        /// <summary>
        /// プロセッサー最大周波数ヘルツ
        /// </summary>
        public double? ProcessorMaxFrequencyHertz;
        /// <summary>
        /// プロセッサー名
        /// </summary>
        public string? ProcessorName;
        /// <summary>
        /// ランタイムバージョン
        /// </summary>
        public string? RuntimeVersion;
    }

    /// <summary>
    /// ベンチマークジョブ情報
    /// </summary>
    public struct BenchmarkJobInfo
    {
        /// <summary>
        /// ジョブの説明
        /// </summary>
        public string? Description;
        /// <summary>
        /// ジョブプラットフォーム
        /// </summary>
        public string? Platform;
        /// <summary>
        /// ジョブランタイムの呼称
        /// </summary>
        public string? RuntimeMoniker;
        /// <summary>
        /// ジョブランタイム名
        /// </summary>
        public string? RuntimeName;
    }

    /// <summary>
    /// ベンチマークメジャータイプ
    /// </summary>
    public enum BenchmarkMeasureType
    {
        /// <summary>
        /// ナノ秒単位の期間
        /// </summary>
        Duration = 0,
        /// <summary>
        /// ナノ秒単位の実行時間
        /// </summary>
        RunTime = 1,
        /// <summary>
        /// バイト単位の平均ヒープ割り当て量
        /// </summary>
        MeanHeapAllocations = 2,
        /// <summary>
        /// バイト単位の合計ヒープ割り当て量
        /// </summary>
        TotalHeapAllocations = 3,
        /// <summary>
        /// ナノ秒単位のアプリケーション起動
        /// </summary>
        ApplicationLaunch = 4,
        /// <summary>
        /// ガベージコレクター gen0 カウント
        /// </summary>
        GarbageCollectorGen0 = 5,
        /// <summary>
        /// ガベージコレクター gen1 カウント
        /// </summary>
        GarbageCollectorGen1 = 6,
        /// <summary>
        /// ガベージコレクター gen2 カウント
        /// </summary>
        GarbageCollectorGen2 = 7,
        /// <summary>
        /// メモリ総動作数
        /// </summary>
        MemoryTotalOperations = 8,
    }
}

using System.Reflection;
using Datadog.Trace.Ci;

var module = TestModule.Create(Assembly.GetExecutingAssembly().GetName().Name ?? "(dyn_module)");
module.SetTag("ModuleTag", "Value");

var suite = module.GetOrCreateSuite("MySuite");
suite.SetTag("SuiteTag", 42);

var test = suite.CreateTest("Test01");
test.SetTag("TestTag", "Value");
test.SetParameters(new TestParameters
{
    Arguments = new Dictionary<string, object>
    {
        ["a"] = 42,
        ["b"] = 0,
    }
});
test.SetTraits(new Dictionary<string, List<string>>
{
    ["Category"] = new () { "UnitTest" }
});

try
{
    var a = 42;
    var b = 0;
    var c = a / b;
}
catch (Exception ex)
{
    test.SetErrorInfo(ex);
}

test.Close(TestStatus.Fail);
suite.Close();
await module.CloseAsync();