onsi/ginkgo

A Modern Testing Framework for Go

9.0kStars on the repository
15Mods indexed here, across every type
22d agoLast push, which is what freshness is scored on
MITLicence, which decides whether bodies are shown

ci

01

onsi/ginkgo

Skill Claude CodeCodex

Configure Ginkgo for continuous integration — the recommended CLI flag set and the rationale for each flag (-r -p --randomize-all --randomize-suites --fail-on-pending --fail-on-empty --keep-going --cover --race --trace --json-report --timeout --poll-progress-after/-interval), invoking via go run to pin the CLI to…

9.0k +3 22d ago A 132 tokens original MIT

debugging-failures

02

onsi/ginkgo

Skill Claude CodeCodex

Diagnose a failing Ginkgo suite as an agent — always run with --json-report into a predictable temp/gitignored location, read the terminal verdict line, then use jq to extract structured failure details (name, message, file:line, panic value, captured logs). Covers the panicked-vs-failed trap, panic locations pointing…

9.0k +3 22d ago A 122 tokens original MIT

decorators

03

onsi/ginkgo

Skill Claude CodeCodex

One-line reference for every Ginkgo decorator, grouped by what it does, with the node types each can decorate — Serial, Ordered, ContinueOnFailure, OncePerOrdered, Label, Focus, Pending, FlakeAttempts, MustPassRepeatedly, NodeTimeout, SpecTimeout, GracePeriod, PollProgressAfter/Interval, SuppressProgressReporting…

9.0k +3 22d ago A 108 tokens original MIT

filtering

04

onsi/ginkgo

Skill Claude CodeCodex

Run a subset of a Ginkgo suite — Pending/PIt/XIt, runtime Skip, programmatic Focus/FIt (and ginkgo unfocus), Label with the --label-filter query language and label sets, suite-level labels, SemVerConstraint/--sem-ver-filter, --focus/--skip and --focus-file/--skip-file, the filtering precedence rules, and…

9.0k +3 22d ago A 117 tokens original MIT

ordering-and-flakes

05

onsi/ginkgo

Skill Claude CodeCodex

Control spec ordering and manage flaky specs — Serial, Ordered containers with BeforeAll/AfterAll/ContinueOnFailure, OncePerOrdered, SpecPriority, plus FlakeAttempts/--flake-attempts, MustPassRepeatedly, --repeat, and --until-it-fails. Use when specs must run in a fixed order, you need once-per-group setup, you're…

9.0k +3 22d ago A 111 tokens original MIT

overview

06

onsi/ginkgo

Skill Claude CodeCodex

The Ginkgo mental model for writing Go tests — the one idea that explains everything (Ginkgo builds a spec tree at construction time, then runs it) and its consequences for how you write specs, plus spec independence and the node taxonomy. Use this first when you start working with Ginkgo in a project, or to decide…

9.0k +3 22d ago A 84 tokens original MIT

parallelism

07

onsi/ginkgo

Skill Claude CodeCodex

Run Ginkgo suites in parallel — ginkgo -p / --procs, the separate-process (not goroutine) model, SynchronizedBeforeSuite/SynchronizedAfterSuite vs BeforeSuite, GinkgoParallelProcess() for sharding ports/tmpdirs/databases, building a binary once via gexec, and piping child-process output to GinkgoWriter. Use when…

9.0k +3 22d ago A 108 tokens original MIT

reporting

08

onsi/ginkgo

Skill Claude CodeCodex

Generate, consume, and enrich Ginkgo reports — console verbosity (-v/-vv/--trace/--no-color/--succinct), machine-readable reports (--json-report/--junit-report with --output-dir/--keep-separate-reports), programmatic reporting nodes (ReportAfterEach, ReportAfterSuite, CurrentSpecReport), AddReportEntry with…

9.0k +3 22d ago A 124 tokens original MIT

running

09

onsi/ginkgo

Skill Claude CodeCodex

Run Ginkgo suites with the ginkgo CLI — run, -r, -p, --dry-run, watch, build (precompiled .test binaries), generate, outline, unfocus, labels, version; spec randomization (--randomize-all/--randomize-suites/--seed); running multiple suites (--keep-going/--skip-package/--compilers); previewing (--dry-run…

9.0k +3 22d ago A 142 tokens original MIT

setup

10

onsi/ginkgo

Skill Claude CodeCodex

Wire Ginkgo into a Go package — install the ginkgo CLI and Ginkgo+Gomega, ginkgo bootstrap to generate the suitetest.go (TestXxx/RegisterFailHandler(Fail)/RunSpecs), the package xxxtest convention, dot-import alternatives (aliased import, dsl/ subpackages, --nodot), ginkgo generate, and testing.T interop via…

9.0k +3 22d ago A 118 tokens original MIT

onsi/ginkgo

Skill Claude CodeCodex

Parameterize and generate Ginkgo specs — DescribeTable/Entry table-driven specs, Entry descriptions (string, nil, closure, EntryDescription), PEntry/FEntry and per-Entry decorators, DescribeTableSubtree, generating specs in a construction-time loop, loading fixtures in TestXxx before RunSpecs, and shared-behavior…

9.0k +3 22d ago A 103 tokens original MIT

timeouts-and-async

12

onsi/ginkgo

Skill Claude CodeCodex

Make Ginkgo specs interruptible and test asynchronous behavior — SpecContext/context.Context cancellable nodes, NodeTimeout/SpecTimeout/GracePeriod, the --timeout flag, Abort and SIGINT behavior, Gomega Eventually/Consistently (the func(g Gomega) form, .WithContext), and the defer GinkgoRecover() rule for goroutines.…

9.0k +3 22d ago A 106 tokens original MIT

writing-specs

13

onsi/ginkgo

Skill Claude CodeCodex

Author good Ginkgo specs — container nodes (Describe/Context/When), subject nodes (It/Specify), setup/cleanup nodes (BeforeEach, JustBeforeEach, AfterEach, DeferCleanup, BeforeSuite/AfterSuite), the "declare in container, initialize in BeforeEach" rule, separating creation from configuration, reusable test helpers…

9.0k +3 22d ago A 120 tokens original MIT