# didi/sharingan

Sharingan（写轮眼）是一个基于golang的流量录制回放工具，适合项目重构、回归测试等。

Repository: https://github.com/didi/sharingan
Canonical: https://ross.abutalabs.com/products/sharingan
Language: Go
License: Apache-2.0
License Family: permissive
Topics: golang, mock-server, recorder, replayer, smoke-test, testing-tools
Archived: true
Last push: 2023-09-29T04:22:23+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2334, "days_push": 1069, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2388, forks 351 (observed 2026-08-28T04:06:42.759311+00:00)

## What it is
Sharingan is a Go-based traffic recording and replay tool that captures real production request traffic (including downstream calls) and replays it offline with mocked downstream responses. It is designed for regression testing and project refactoring, offering noise removal, time resetting, batch replay, and coverage reports.

## Use cases
- record production traffic for regression testing
- replay recorded traffic after refactoring a service
- mock downstream service calls during offline testing
- generate coverage reports from replayed traffic
- replay write traffic without polluting data
- batch replay traffic for smoke testing

## When to choose
- you maintain Go services and need realistic regression tests without hand-built fixtures
- downstream dependencies make test environments unstable
- you are refactoring a microservice and want to verify behavior against real traffic

## When to avoid
- your services are not written in Go (it requires a patched Go toolchain, go1.10–go1.15)
- you need traffic mirroring to a live environment rather than offline replay
- you need support for modern Go versions

## Facets
- artifact type: library
- maturity: maintenance
- function: testing, mocking, e2e-testing
- domain: testing, developer-tools, backend, microservices
- platform: go, cli
- tags: traffic-recording, traffic-replay, regression-testing, mock-server, golang, linux, macos

## Member repositories
- didi/sharingan (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:42.759311+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-30T02:34:33.238436+00:00, confidence not recorded.
  - readme: https://github.com/didi/sharingan (fetched 2026-08-28T04:06:42.759311+00:00, sha 0769fd9e20b6)
- Data as of 2026-08-30T08:39:29.467469+00:00.