CodeRoad.CSharp.TapRunner 0.1.0

CodeRoad C# TapRunner

A small cross-platform .NET tool that runs a test project, reads its TRX results, and writes TAP 13 output for CodeRoad tutorials.

Requirements

• .NET 10 SDK or later
• A test project supported by dotnet test

Install

Install from NuGet.org:

dotnet tool install --global CodeRoad.CSharp.TapRunner

For reproducible tutorial repositories, prefer a local tool manifest:

dotnet new tool-manifest
dotnet tool install CodeRoad.CSharp.TapRunner --version 0.1.0
dotnet tool restore

Usage

coderoad-taprunner \
  --project tests/MyTutorial.Tests/MyTutorial.Tests.csproj \
  --filter Step_1_1 \
  --tap

--project is required. --filter accepts either a test category such as Step_1_1 or a complete VSTest filter expression. The --tap flag is accepted for compatibility with CodeRoad commands; TAP output is always produced.

Example coderoad.yaml command when the tool is installed through a local manifest:

command: dotnet tool run coderoad-taprunner -- --project tests/MyTutorial.Tests/MyTutorial.Tests.csproj

CodeRoad can append its filter and TAP arguments to that command.

Build and package

dotnet build --configuration Release
dotnet pack --configuration Release --output artifacts

Install the generated package locally:

dotnet tool install --global CodeRoad.CSharp.TapRunner \
  --add-source artifacts \
  --version 0.1.0

Publish

Publishing uses NuGet Trusted Publishing with GitHub OIDC. No long-lived NuGet API key is stored in GitHub.

1. On nuget.org, open Trusted Publishing and add a GitHub Actions policy with:

• Owner: coderoad-csharp
• Repository: TapRunner
• Workflow file: publish.yml
• Environment: release

2. In the GitHub repository, create an environment named release.
3. Add the repository variable NUGET_USER containing the nuget.org username that owns or can publish the package. Use the profile name, not an email address.
4. Create and push a version tag, for example v0.1.0.

The publish.yml workflow exchanges its GitHub OIDC token for a short-lived NuGet API key immediately before publishing the tagged package.

License

Licensed under the MIT License.