Introduction
GripMock is your go-to tool for testing gRPC services. It creates a mock server that responds exactly how you want it to, making testing faster and more reliable.
What is GripMock?
GripMock is a mock server for gRPC services. Give it your .proto
files, and it instantly creates a working server that responds with your predefined test data. Perfect for testing your applications without needing a real backend server.
Why Use GripMock?
- Fast Setup: Get a working server in seconds
- Easy Testing: Define responses in simple YAML or JSON files
- Real Scenarios: Test file uploads, chat applications, and data streaming
- No Dependencies: Works with any programming language that supports gRPC
- Production Ready: Built-in health checks and Docker support
Key Features
- Quick Start: Use your
.proto
files to generate a server instantly - YAML & JSON: Define your test responses in the format you prefer
- Health Monitoring: Built-in health checks for production deployment
- Header Testing: Test different authentication tokens and headers
- Error Simulation: Test how your app handles real-world errors
- File Upload Testing: Test chunked file uploads and batch processing
- Real-time Chat: Test bidirectional streaming for chat applications
- Web Interface: Manage your test scenarios through a friendly web UI
- Docker Ready: Lightweight container perfect for CI/CD pipelines
- 20-35% Faster: Latest improvements make your tests run quicker
- Zero Breaking Changes: All your existing tests continue to work
Streaming Support
GripMock supports all types of gRPC communication:
Simple Requests (1:1)
Traditional request-response - you send one message, get one response back.
Data Feeds (1:N) v3.3.0
Send one request, receive multiple responses over time - perfect for real-time data.
File Uploads (N:1) v3.4.0
Send multiple messages (like file chunks), receive one summary response.
Real-time Chat (N:N) v3.4.0
Send and receive messages continuously - ideal for chat apps and live collaboration.
Web Interface v3.0.0
The dashboard provides a user-friendly way to:
- Create and edit test responses
- Monitor which responses are being used
- Manage your test scenarios visually
Access it at http://localhost:4771/
when you start GripMock.
Getting Started
- Install: Download or use Docker
- Configure: Point to your
.proto
files - Define Responses: Create YAML/JSON files with your test data
- Test: Your mock server is ready!
Need Help?
Stuck with something? Check out our GitHub issues page or join our community discussions.