KaizenReport.Kensho.Xunit 0.3.0

KaizenReport.Kensho.Xunit

xUnit hook that emits the canonical Kensho v1 JSON format.

xUnit doesn't ship a logger SPI like NUnit's ITestEventListener or VSTest's ITestLogger, so this adapter uses xUnit's BeforeAfterTestAttribute extensibility point. Apply the attribute at the assembly level (or inherit KenshoTestBase) and the writer takes care of the rest.

Install

dotnet add package KaizenReport.Kensho.Xunit

Wire it up by adding one line:

[assembly: KaizenReport.Kensho.Xunit.KenshoTracked]

Or extend the helper base class:

public class CartTests : KaizenReport.Kensho.Xunit.KenshoTestBase
{
    [Fact]
    public void Adds_first_item() { /* ... */ }
}

Run

dotnet test
# => kensho-results/run.json + kensho-results/cases/*.json

npx kensho generate
npx kensho open

Configuration

Environment variables:

Mapping xUnit → Kensho

Outcome detection — known limitation

xUnit's BeforeAfterTestAttribute does not receive the test outcome in After(). The pragmatic workaround:

1. The helper API still works — using (Kensho.Step("...")) blocks that throw will be marked fail, and the case status reflects them.
2. For assertion failures outside of a step, wrap the assertion in a Kensho.Step("assert ...") block. xUnit's exception will close the step as fail, which the writer reads as a failed case.
3. Alternatively, install the framework name as junit-xml (the default) and add a small post-run xUnit logger pass — outside the scope of this adapter.

Because the xUnit name is not in the Kensho v1 framework enum, the adapter writes framework.name = "junit-xml". Bumping the schema to add xunit is a v2 concern.

Helper API

using KaizenReport.Kensho.Core;
using Xunit;

public class LoginTests : KaizenReport.Kensho.Xunit.KenshoTestBase
{
    [Fact]
    public void Redirects_to_home_after_signin()
    {
        using (Kensho.Step("open the login page"))
            Page.Goto("/login");

        using (Kensho.Step("submit credentials"))
        {
            Page.Fill("#user", "demo");
            Page.Click("text=Sign in");
        }

        Kensho.Label("team", "growth");
        Kensho.Link("https://jira.example.com/browse/PROJ-123",
                    kind: "jira", label: "PROJ-123");
        Kensho.Attach("/tmp/login.png", kind: "screenshot");
    }
}

License

Apache-2.0.