bbdrummer/dummy-responder

🤖 Dummy Responder Service

A lightweight, standalone HTTP service for testing and development with WebSocket and Server-Sent Events (SSE) support. Perfect for mocking APIs, simulating network conditions, and testing real-time communication.

---

• Repository: GitLab
• Documentation: [***]
• Live API: [***]
• License: MIT

---

🚀 Quick Start

bash
# Run with Docker
docker run -p 8080:8080 bbdrummer/dummy-responder:latest

# Test basic functionality
curl http://localhost:8080/health

# Test with custom parameters
curl "http://localhost:8080/?responseCode=200&message=Hello&responseTime=1s"

✨ Key Features

• 🔧 Configurable HTTP responses - status codes, delays, failure rates
• 🌐 WebSocket support - real-time message streaming
• 📡 Server-Sent Events (SSE) - live event streaming
• 🧪 Built-in test page - interactive WebSocket & SSE testing
• � OpenAPI/Swagger documentation - auto-generated API docs
• �📊 Multiple content types - JSON, plain text, HTML
• ⚡ Zero dependencies - single ***ary, fast startup
• 🐳 Container-ready - lightweight Alpine-based image (~10MB)

📖 Usage Examples

HTTP API Testing

bash
# Simple response
curl http://localhost:8080/

# Random status codes with 30% failure rate
curl "http://localhost:8080/?responseCode=random&failureRate=0.3"

# Simulate slow API (2 second delay)
curl "http://localhost:8080/?responseTime=2s&message=Slow%20API"

# Different content types
curl "http://localhost:8080/?contentType=text/plain&message=Plain%20text"

Real-time Communication Testing

bash
# WebSocket (requires wscat: npm install -g wscat)
wscat -c "ws://localhost:8080/ws?message=Hello&wsInterval=2s"

# Server-Sent Events
curl -N "http://localhost:8080/sse?message=Live%20Events&sseInterval=1s"

# Interactive test page
open http://localhost:8080/test

🔧 Configuration Parameters

🛠️ Available Endpoints

🎯 Perfect For

• API mocking during development
• Network condition simulation (delays, failures)
• Real-time feature testing (WebSocket, SSE)
• Load testing baselines
• CI/CD pipeline integration
• Service discovery testing
• Demo environments

🏗️ Deployment Options

Docker

bash
# Basic run
docker run -p 8080:8080 bbdrummer/dummy-responder

# With custom port
docker run -p 3000:8080 bbdrummer/dummy-responder

# Background with restart policy
docker run -d --restart unless-stopped -p 8080:8080 bbdrummer/dummy-responder

Docker Compose

yaml
version: '3.8'
services:
  dummy-responder:
    image: bbdrummer/dummy-responder:latest
    ports:
      - "8080:8080"
    restart: unless-stopped

Kubernetes

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: dummy-responder
spec:
  replicas: 1
  selector:
    matchLabels:
      app: dummy-responder
  template:
    metadata:
      labels:
        app: dummy-responder
    spec:
      containers:
      - name: dummy-responder
        image: bbdrummer/dummy-responder:latest
        ports:
        - containerPort: 8080
        resources:
          requests:
            memory: "32Mi"
            cpu: "50m"
          limits:
            memory: "128Mi"
            cpu: "200m"
---
apiVersion: v1
kind: Service
metadata:
  name: dummy-responder
spec:
  selector:
    app: dummy-responder
  ports:
  - port: 80
    targetPort: 8080

📊 Response Formats

HTTP JSON Response

json
{
  "message": "Hello World",
  "requestInfo": {
    "method": "GET",
    "path": "/",
    "query": "responseCode=200&message=Hello"
  },
  "timestamp": "2025-08-30T09:17:30Z",
  "config": {
    "responseCode": 200,
    "failureRate": 0.1,
    "responseTime": "1s",
    "message": "Hello World"
  }
}

WebSocket Message

json
{
  "message": "Hello WebSocket",
  "counter": 1,
  "timestamp": "2025-08-30T09:17:30Z",
  "service": "dummy-responder",
  "type": "websocket"
}

SSE Event

id: 1
event: message
data: {"message":"Hello SSE","counter":1,"timestamp":"2025-08-30T09:17:30Z","service":"dummy-responder","type":"sse"}

🔍 Health Check

bash
curl http://localhost:8080/health

json
{
  "status": "healthy",
  "service": "dummy-responder",
  "timestamp": "2025-08-30T09:17:30Z"
}

🧪 Interactive Testing

Built-in Test Interface

Visit http://localhost:8080/test in your browser for an interactive test page where you can:

• Test WebSocket connections with custom parameters
• Test SSE streams with configurable intervals
• See real-time connection status and message logs
• Easily experiment with different settings

API Documentation

Visit http://localhost:8080/swagger/ for complete OpenAPI documentation with:

• Interactive API explorer - test endpoints directly from the docs
• Request/response examples with proper schemas
• Parameter descriptions and validation
• Complete endpoint coverage including WebSocket and SSE

💡 Why Use Dummy Responder?

1. 🚀 Fast startup - Ready in milliseconds
2. 🪶 Lightweight - <10MB Docker image
3. 🔧 Flexible - Configure everything via URL parameters
4. 🌐 Real-time ready - WebSocket & SSE support built-in
5. 🧪 Test-friendly - Built-in interactive test page
6. 📦 Zero config - No databases, no config files
7. 🔄 Realistic - Simulates real-world network conditions

Perfect for developers who need a reliable, configurable service for testing and development! 🎯

Visit [***] for complete developers' documentation.