README
¶
Gopher-Glide (gg) 🚀
High-fidelity API traffic simulation from your IDE. Beyond brute-force load testing.
Gopher-Glide (gg) is an open-source, high-fidelity API traffic simulator built in Go. Designed to move beyond brute-force load testing, gg runs your standard IDE .http REST Client files right out of the box.
Generate perfectly smooth, high-concurrency traffic using the lock-free Actor Model. Adjust RPS in real-time via the interactive TUI, catch API regressions using semantic snapshots (gg snap), and integrate natively into your CI/CD pipelines. No scripting, no boilerplate code.
Quick Start
1. macOS / Linux (Homebrew)
The easiest way to install is via Homebrew:
brew install shyam-s00/tap/gg
2. Docker
Perfect for CI/CD pipelines:
docker run --rm -v $(pwd):/workspace ghcr.io/shyam-s00/gopher-glide:latest config.yaml
3. Pre-built binary
Go to the Releases page and download the archive for your platform. Extract the binary and place it in your $PATH.
🔌 JetBrains IDE Integration
Gopher Glide features an official JetBrains plugin that brings load testing directly into your IDE.
- Smart YAML editing for
config.yaml - Terminal-First Execution
- Snap UI Tool Window for exploring Snapshots
🚀 Performance
The Hive Engine is built for maximum throughput with zero garbage-collection penalties.
- Sequential Peak: ~31,000 Requests Per Second (RPS) per core.
- Parallel Aggregate: ~89,000+ RPS total system throughput on standard 12-core hardware.
- Zero Garbage on the hot path: Each Actor's per-request counter-updates (RPS window, sharded totals) use lock-free atomics with no heap allocations. The ~10 Hz TUI snapshot (
GetMetrics) does allocate a fixed-size[]float64of 4 096 entries to compute latency percentiles, but this is well outside the request dispatch path and has negligible GC impact.
For full technical breakdown and latency details, see the Official Benchmarks.
Planned Features
- Chaos / Fault Injection — Simulate poor network conditions (3G packet loss, latency jitter) to see how APIs handle degradation.
- Distributed Simulation Mesh — Run
gg workernodes across multiple servers/regions, controlled by a centralgg masterUI. - Auto-Pilot (Smart Scaling) — Set a
--target-latencyand let the engine automatically ramp RPS to find your API's exact breaking point.
License
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
gg
command
|
|
|
internal
|
|
|
engine/hive
Package hive implements the Hive Engine — an Actor Model load engine.
|
Package hive implements the Hive Engine — an Actor Model load engine. |
|
snap
Package snap provides behavioral snapshot capture for gg load test runs.
|
Package snap provides behavioral snapshot capture for gg load test runs. |
|
ui
Package ui provides the Renderer abstraction that decouples application logic from the presentation layer.
|
Package ui provides the Renderer abstraction that decouples application logic from the presentation layer. |