GetSkipper.Core 1.1.0

skipper-dotnet

Test-gating for .NET — skip tests dynamically via a Google Spreadsheet, without touching your test code.

What is Skipper?

Skipper reads a Google Spreadsheet to decide which tests to skip. Each row has:

• disabledUntil is in the future → test is skipped automatically
• disabledUntil is empty or in the past → test runs normally
• Test not in spreadsheet → test runs normally (opt-out model)

No code changes required in your tests. Configure once, gate everywhere.

Packages

Package	Description	NuGet
GetSkipper.Core	Google Sheets client, resolver, writer
GetSkipper.XUnit	xUnit v2/v3 integration
GetSkipper.NUnit	NUnit 3/4 integration
GetSkipper.MSTest	MSTest v3 integration
GetSkipper.Playwright	Playwright for .NET
GetSkipper.SpecFlow	Reqnroll (SpecFlow) BDD

Quick Start

xUnit (zero changes to your tests)

// AssemblyInfo.cs — add once to your test project
using GetSkipper.XUnit;

[assembly: TestFramework("GetSkipper.XUnit.SkipperTestFramework", "GetSkipper.XUnit")]
[assembly: SkipperConfig(
    SpreadsheetIdEnvVar = "SKIPPER_SPREADSHEET_ID",
    CredentialsFile = "service-account.json")]

// Your tests remain unchanged:
public class AuthTests
{
    [Fact]
    public void CanLogin() { /* ... */ }
}

NUnit (zero changes to your tests)

// AssemblyInfo.cs
using GetSkipper.NUnit;

[assembly: SkipperConfig(
    SpreadsheetId = "1abc...",
    CredentialsFile = "service-account.json")]

// Your tests remain unchanged:
[TestFixture]
public class AuthTests
{
    [Test]
    public void CanLogin() { /* ... */ }
}

MSTest (zero changes to your tests)

// SkipperSetup.cs — add once to your test project
using GetSkipper.Core;
using GetSkipper.Core.Credentials;
using GetSkipper.MSTest;
using Microsoft.VisualStudio.TestTools.UnitTesting;

public static class SkipperSetup
{
    [GlobalTestInitialize]
    public static async Task InitAsync()
        => await SkipperGlobalHooks.ConfigureAsync(new SkipperConfig
        {
            SpreadsheetId = "1abc...",
            Credentials = new FileCredentials("service-account.json"),
        });

    [GlobalTestCleanup]
    public static Task CleanupAsync() => SkipperGlobalHooks.AfterAllTestsAsync();
}

// Intercept each test (call from a second [GlobalTestInitialize] or use one method):
public static class SkipperTestGate
{
    [GlobalTestInitialize]
    public static void BeforeTest(TestContext ctx) => SkipperGlobalHooks.BeforeTest(ctx);
}

Playwright (change base class only)

using GetSkipper.NUnit;
using GetSkipper.Playwright;

[assembly: SkipperConfig(SpreadsheetId = "1abc...", CredentialsFile = "service-account.json")]

[TestFixture]
public class LoginTests : SkipperPageTest  // was: PageTest
{
    [Test]
    public async Task UserCanLogin()
    {
        await Page.GotoAsync("/login");
        // automatic skip is handled before this line
    }
}

Reqnroll / SpecFlow (zero changes to step definitions)

// reqnroll.json
{
  "bindingAssemblies": [
    { "assembly": "GetSkipper.SpecFlow" }
  ]
}

SKIPPER_SPREADSHEET_ID=1abc... SKIPPER_CREDENTIALS_FILE=./service-account.json dotnet test

Spreadsheet Format

Test ID formats

Sync Mode

Reconcile the spreadsheet with your test suite (append new tests, remove deleted ones):

SKIPPER_MODE=sync dotnet test

Typically run on main after all tests pass:

# .github/workflows/ci.yml
- name: Run tests in sync mode
  if: github.ref == 'refs/heads/main'
  env:
    SKIPPER_MODE: sync
    SKIPPER_SPREADSHEET_ID: ${{ secrets.SKIPPER_SPREADSHEET_ID }}
    GOOGLE_CREDS_B64: ${{ secrets.GOOGLE_CREDS_B64 }}
  run: dotnet test

Credentials

Three ways to supply the Google service account:

// 1. JSON file (local dev)
Credentials = new FileCredentials("./service-account.json")

// 2. Base-64 encoded JSON (CI secrets)
Credentials = new Base64Credentials(Environment.GetEnvironmentVariable("GOOGLE_CREDS_B64")!)

// 3. Inline object
Credentials = new ServiceAccountCredentials(
    clientEmail: "skipper@project.iam.gserviceaccount.com",
    privateKey: "-----BEGIN RSA PRIVATE KEY-----\n...")

Environment Variables

License

MIT — see LICENSE.