# dnaeon/go-vcr

Record and replay your HTTP interactions for fast, deterministic and accurate tests

Repository: https://github.com/dnaeon/go-vcr
Canonical: https://ross.abutalabs.com/products/go-vcr
Language: Go
License: BSD-2-Clause
License Family: permissive
Topics: go, golang, testing
Last push: 2026-07-16T06:03:33+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 92, release rhythm 66, longevity 100
- inputs: {"age_days": 3915, "days_push": 48, "days_rel": 69, "gap_med": 100, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1394, forks 81 (observed 2026-08-28T04:04:36.419075+00:00)

## What it is
A Go library inspired by Ruby's VCR that records HTTP interactions to YAML cassettes and replays them in future test runs. It enables fast, deterministic, and accurate testing of code that makes external HTTP calls without hitting real servers.

## Use cases
- record and replay HTTP interactions in Go tests
- make Go tests deterministic without live API calls
- mock external HTTP APIs in unit tests
- speed up test suites that depend on remote services
- create reusable HTTP fixtures for testing
- test HTTP clients offline

## When to choose
- you write Go code that talks to external HTTP APIs and want reliable tests
- you want VCR-style cassette-based HTTP recording in Go
- you need reproducible tests without network flakiness or rate limits

## When to avoid
- you need mocking for non-HTTP protocols like gRPC or WebSockets
- you are not working in Go
- you need a general-purpose HTTP mock server rather than record/replay

## Facets
- artifact type: library
- maturity: active
- function: testing, mocking, http-client
- domain: testing, developer-tools, apis
- platform: go, cli
- tags: http-recording, vcr, cassette, deterministic-tests, test-fixtures

## Member repositories
- dnaeon/go-vcr (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:36.419075+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-30T04:39:26.215450+00:00, confidence not recorded.
  - readme: https://github.com/dnaeon/go-vcr (fetched 2026-08-28T04:04:36.419075+00:00, sha 2cec775825d4)
- Data as of 2026-08-30T08:39:29.467469+00:00.