AutoFixtureはNuGetパッケージとして利用可能であり、NuGetパッケージマネージャーコンソールまたはVisual StudioのNuGetパッケージマネージャーUIで.NETパッケージを追加することでインストールできます。

Install-Package AutoFixture

NuGetはプロジェクトにAutoFixtureとその依存関係の最新バージョンをダウンロードしてインストールします。

クラスのテストデータ作成例

Age のようなプロパティを持つ単純な従業員クラスがあるとします。 このクラスのインスタンスを単体テストで手動で作成する代わりに、AutoFixtureを活用してランダムデータを生成することができます。

public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }

    public Employee(string firstName, string lastName, int age)
    {
        FirstName = firstName;
        LastName = lastName;
        Age = age;
    }

    public string GetFullName() => $"{FirstName} {LastName}";
}

public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }

    public Employee(string firstName, string lastName, int age)
    {
        FirstName = firstName;
        LastName = lastName;
        Age = age;
    }

    public string GetFullName() => $"{FirstName} {LastName}";
}

コードの説明

Employee クラスは、従業員の重要な詳細 (名、姓、年齢など) をカプセル化します。これらの詳細情報は、それぞれ Age のプロパティで表されます。 コンストラクタはこれらの詳細をパラメータとして受け取り、対応するプロパティに割り当てることで従業員オブジェクトのインスタンス化を容易にします。 さらに、GetFullName メソッドは従業員の名と姓を連結し、フルネームを文字列として返します。

次に、Employee クラスをテストするためのテスト クラスを作成します。

using AutoFixture;

public class EmployeeTests
{
    private readonly IFixture _fixture;

    public EmployeeTests()
    {
        // Using AutoFixture's Fixture to create test data
        _fixture = new Fixture();
    }
}

using AutoFixture;

public class EmployeeTests
{
    private readonly IFixture _fixture;

    public EmployeeTests()
    {
        // Using AutoFixture's Fixture to create test data
        _fixture = new Fixture();
    }
}

コードの説明

このコード スニペットは、Employee クラスの単体テストに AutoFixture を組み込みます。 AutoFixture 名前空間をインポートすることで、開発者はデータ生成機能にアクセスします。 _fixture フィールドは、Fixture の新しいインスタンスで初期化され、テスト データの作成を効率化します。 このセットアップにより、包括的な Employee クラス カバレッジのテスト効率と信頼性が向上します。

例1: 従業員のテストケースオブジェクト値の検証

[Fact]
public void Employee_ShouldHaveValidValues()
{
    // Arrange
    var firstName = _fixture.Create<string>();
    var lastName = _fixture.Create<string>();
    var age = _fixture.Create<int>();

    // Act
    var employee = new Employee(firstName, lastName, age);

    // Assert
    Assert.Equal(firstName, employee.FirstName);
    Assert.Equal(lastName, employee.LastName);
    Assert.Equal(age, employee.Age);
}

[Fact]
public void Employee_ShouldHaveValidValues()
{
    // Arrange
    var firstName = _fixture.Create<string>();
    var lastName = _fixture.Create<string>();
    var age = _fixture.Create<int>();

    // Act
    var employee = new Employee(firstName, lastName, age);

    // Assert
    Assert.Equal(firstName, employee.FirstName);
    Assert.Equal(lastName, employee.LastName);
    Assert.Equal(age, employee.Age);
}

コードの説明

テスト メソッド Employee_ShouldHaveValidValues は、Employee クラスが指定された値を使用してプロパティを正しく初期化することを検証します。 テスト フィクスチャを使用して、LastName、および Age のランダム データを生成し、テストでは Employee インスタンスを作成します。 次に、Employee オブジェクトの LastName、および Age プロパティが生成された値と一致することをアサートし、コンストラクターがこれらのプロパティを正確に設定していることを確認します。

例2: コンストラクタが呼び出されたときの従業員の検証

[Fact]
public void CreateEmployee_ValidData_ReturnsEmployeeObject()
{
    // Arrange
    var employee = _fixture.Create<Employee>();

    // Act 
    // Assert
    Assert.NotNull(employee);
    Assert.False(string.IsNullOrEmpty(employee.FirstName));
    Assert.NotNull(employee.LastName);
    Assert.True(employee.Age > 0);
}

[Fact]
public void CreateEmployee_ValidData_ReturnsEmployeeObject()
{
    // Arrange
    var employee = _fixture.Create<Employee>();

    // Act 
    // Assert
    Assert.NotNull(employee);
    Assert.False(string.IsNullOrEmpty(employee.FirstName));
    Assert.NotNull(employee.LastName);
    Assert.True(employee.Age > 0);
}

コードの説明

このテスト メソッドには、Employee オブジェクトのプロパティがランダムに生成された値と一致するかどうかを検証するテスト アサーションが含まれています。 string 型プロパティ FirstName および LastName、および int Age が適切に設定され、有効であるかどうかを確認します。 失敗したアサーションは、従業員詳細の期待値とランダムに生成された値の不一致を示します。

IronPDFの紹介

IronPDF C# PDFライブラリは、Iron Softwareによって開発された、PDFテキストの読み取り、およびHTMLを使用してPDFドキュメントを作成するための強力なC# PDFライブラリです。 この多用途なツールは、スタイル情報を含めた簡単にフォーマット可能な文書を、高品質なPDFに変換することを可能にします。 IronPDFを使用すると、HTMLからPDFを生成するプロセスがシームレスで、ユーザーはURLからHTMLコンテンツを取得し、それを構造化されたPDFファイルに変換できます。 この機能は、Webコンテンツから直接プロフェッショナルなPDFドキュメントを自動化および効率化することを望む開発者にとって、IronPDFは不可欠なツールとなっています。

NuGetパッケージ管理コンソールを開き、次のコマンドを実行します。

Install-Package IronPdf

IronPDFでAutoFixtureの機能を使用するコード例

以下は、AutoFixtureとIronPDFを組み合わせて従業員データのPDFを生成する例です。

using DemoAutofixture;
using IronPdf;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

public class EmployeePdfGenerator
{
    private readonly Fixture _fixture;

    public EmployeePdfGenerator()
    {
        _fixture = new Fixture();
    }

    public List<Employee> GenerateEmployees(int count)
    {
        return _fixture.CreateMany<Employee>(count).ToList();
    }

    public void GeneratePdf(List<Employee> employees, string filePath)
    {
        IronPdf.License.LicenseKey = "Your-License-Key-Here";
        var renderer = new ChromePdfRenderer();
        string htmlContent = GenerateHtml(employees);

        try
        {
            renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath);
            Console.WriteLine("PDF Created Successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
        }
    }

    private string GenerateHtml(List<Employee> employees)
    {
        StringBuilder htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>");

        foreach (var employee in employees)
        {
            htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>");
        }

        htmlBuilder.Append("</ul></body></html>");
        return htmlBuilder.ToString();
    }
}

using DemoAutofixture;
using IronPdf;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

public class EmployeePdfGenerator
{
    private readonly Fixture _fixture;

    public EmployeePdfGenerator()
    {
        _fixture = new Fixture();
    }

    public List<Employee> GenerateEmployees(int count)
    {
        return _fixture.CreateMany<Employee>(count).ToList();
    }

    public void GeneratePdf(List<Employee> employees, string filePath)
    {
        IronPdf.License.LicenseKey = "Your-License-Key-Here";
        var renderer = new ChromePdfRenderer();
        string htmlContent = GenerateHtml(employees);

        try
        {
            renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath);
            Console.WriteLine("PDF Created Successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
        }
    }

    private string GenerateHtml(List<Employee> employees)
    {
        StringBuilder htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>");

        foreach (var employee in employees)
        {
            htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>");
        }

        htmlBuilder.Append("</ul></body></html>");
        return htmlBuilder.ToString();
    }
}

このクラスを使用するには、EmployeePdfGenerator をインスタンス化し、従業員のリストを生成してから、GeneratePdf を呼び出します。

List<Employee> employees = new()
{
    new Employee("John", "Smith", 32),
    new Employee("Emily", "Davis", 18),
    new Employee("David", "Brown", 24),
    new Employee("Jane", "Doe", 16),
    new Employee("Michael", "Johnson", 49),
};

EmployeePdfGenerator pdfGenerator = new();
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf");

List<Employee> employees = new()
{
    new Employee("John", "Smith", 32),
    new Employee("Emily", "Davis", 18),
    new Employee("David", "Brown", 24),
    new Employee("Jane", "Doe", 16),
    new Employee("Michael", "Johnson", 49),
};

EmployeePdfGenerator pdfGenerator = new();
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf");

コードの説明

提供されたC#コードは、IronPDFライブラリを使用して、社員とその年齢のPDFドキュメントを生成します。 これは、オブジェクトのリストとファイル パスを受け取るメソッド GeneratePdf を含む EmployeePdfGenerator クラスを定義します。 内部的には、GenerateHtml メソッドを通じて HTML コンテンツを構築し、次に IronPDF の HtmlToPdf クラスを使用してこの HTML を PDF としてレンダリングし、指定されたファイル パスに保存します。 機能強化には、HTML 生成に StringBuilder を使用すること、PDF 生成とファイル保存の基本的なエラー処理を追加することが含まれます。

テストメソッドの書き方

以下のセットアップでは、AutoFixture を使用して Employee クラスのインスタンスを作成し、テスト用のランダムなデータの生成を可能にします。 IronPDFはHTMLコンテンツを、従業員情報を含むPDF形式にシームレスに変換します。 EmployeePdfGenerator クラスはこれらのプロセスを調整し、データ生成と PDF 変換の両方を効率的に管理します。 一方、EmployeePdfGeneratorTests XUnit テスト クラスは、厳密なテストを通じて PDF 生成の適切な機能を保証します。 この統合アプローチは、社員データの生成と文書化を簡素化し、PDF生成プロセスにおける堅牢性と信頼性を保証します。

using System.IO;
using Xunit;

public class EmployeePdfGeneratorTests
{
    [Fact]
    public void GeneratePdf_GeneratesPdfFile()
    {
        // Arrange
        var generator = new EmployeePdfGenerator();
        var employees = generator.GenerateEmployees(5);
        string filePath = "EmployeeList.pdf";

        // Act
        generator.GeneratePdf(employees, filePath);

        // Assert
        Assert.True(File.Exists(filePath));
    }
}

using System.IO;
using Xunit;

public class EmployeePdfGeneratorTests
{
    [Fact]
    public void GeneratePdf_GeneratesPdfFile()
    {
        // Arrange
        var generator = new EmployeePdfGenerator();
        var employees = generator.GenerateEmployees(5);
        string filePath = "EmployeeList.pdf";

        // Act
        generator.GeneratePdf(employees, filePath);

        // Assert
        Assert.True(File.Exists(filePath));
    }
}

ここで、EmployeePdfGeneratorTests クラスには、指定されたファイル パスでの PDF ファイルの作成を検証し、GeneratePdf メソッドが正しく機能することを確認するテスト ケースが含まれています。