# onsi/ginkgo

A Modern Testing Framework for Go

Repository: https://github.com/onsi/ginkgo
Canonical: https://ross.abutalabs.com/products/ginkgo
Homepage: http://onsi.github.io/ginkgo/
Language: Go
License: MIT
License Family: permissive
Topics: golang, testing, test, test-driven-development, bdd, bdd-framework, go
Last push: 2026-08-10T22:18:47+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 97, longevity 100
- inputs: {"age_days": 4758, "days_push": 23, "days_rel": 23, "gap_med": 13, "n_releases_24m": 30}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9043, forks 707 (observed 2026-08-28T04:10:28.093908+00:00)

## What it is
Ginkgo is a mature BDD-style testing framework for Go that builds on Go's native testing package. It provides an expressive DSL for structuring specs and pairs with the Gomega matcher library.

## Use cases
- write bdd-style tests in go
- structure unit and integration tests with describe/context/it blocks
- run go tests in parallel
- write acceptance tests for go services
- test asynchronous go code with eventually matchers
- generate test scaffolding from the command line

## When to choose
- you prefer behavior-driven, nested spec structure over plain go test functions
- you want rich matchers and async assertions via gomega
- you need mature, widely adopted go testing tooling

## When to avoid
- you prefer go's standard library testing with plain assertions
- you want a minimal dependency footprint
- you dislike dsl-style test code

## Facets
- artifact type: library
- maturity: stable
- function: testing, e2e-testing, benchmarking
- domain: testing, developer-tools, programming-languages
- platform: go, cli, cross-platform
- tags: bdd, test-framework, gomega, tdd, expressive-specs

## Member repositories
- onsi/ginkgo (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:28.093908+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:24:04.228149+00:00, confidence not recorded.
  - readme: https://github.com/onsi/ginkgo (fetched 2026-08-28T04:10:28.093908+00:00, sha 5850360b06cd)
  - homepage: http://onsi.github.io/ginkgo/ (fetched 2026-08-29T08:24:03.870766+00:00, sha 93c9ec0ed710)
- Data as of 2026-08-30T08:39:29.467469+00:00.