GetSkipper.Playwright 1.2.0

skipper-dotnet

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

👁 NuGet

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

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 .