# vcr/vcr

Record your test suite's HTTP interactions and replay them during future test runs for fast, deterministic, accurate tests.

Repository: https://github.com/vcr/vcr
Canonical: https://ross.abutalabs.com/products/vcr
Homepage: https://benoittgt.github.io/vcr
Language: Ruby
License: NOASSERTION
License Family: other
Last push: 2026-06-23T06:33:13+00:00

## Health v2 (maintenance only)
Score: 71/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 89, release rhythm 30, longevity 100
- inputs: {"age_days": 6033, "days_push": 71, "days_rel": 254, "gap_med": null, "n_releases_24m": 1}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6077, forks 511 (observed 2026-08-28T04:09:34.826919+00:00)

## What it is
VCR is a Ruby library that records your test suite's real HTTP interactions into 'cassette' files and replays them on subsequent runs. It integrates with stubbing libraries like WebMock, Typhoeus, Faraday, and Excon to make tests fast, deterministic, and offline-capable.

## Use cases
- record and replay HTTP responses in Ruby tests
- make test suite independent of external APIs
- run tests offline deterministically
- avoid flaky tests caused by third-party API changes
- speed up integration tests by removing real network calls
- filter sensitive data from recorded HTTP fixtures

## When to choose
- you write Ruby tests that hit external HTTP APIs and want reproducible fixtures
- you need fast, deterministic tests without live network dependencies
- you already use WebMock, Typhoeus, Faraday, or Excon

## When to avoid
- you need to test against live, changing API behavior
- you are not working in Ruby
- you need mocking for non-HTTP protocols

## Facets
- artifact type: library
- maturity: maintenance
- function: testing, mocking, http-client
- domain: testing, developer-tools, web-development
- platform: ruby
- tags: http-recording, cassettes, test-doubles, deterministic-tests

## Member repositories
- vcr/vcr (main) score 71

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:34.826919+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:48:21.011174+00:00, confidence not recorded.
  - readme: https://github.com/vcr/vcr (fetched 2026-08-28T04:09:34.826919+00:00, sha 108ab3eeb3bc)
  - homepage: https://benoittgt.github.io/vcr (fetched 2026-08-29T08:44:58.261068+00:00, sha efa260532cec)
- Data as of 2026-08-30T08:39:29.467469+00:00.