A Gatling load testing example in Scala with multiple ways to run simulations against an HTTP target.

Features

• Simulation written in Scala using the Gatling DSL
• Configurable via system properties (URL, duration, rate, thresholds)
• Four execution modes: Maven plugin, executable jar, Docker, Kubernetes Job
• Bundled Node.js HTTP test server as a minimal system under test
• Helm chart for Kubernetes deployment
• GitHub template — clone from a clean slate with one click

Getting Started

Requirements

• JDK 21
• Node.js (for the bundled test server)
• Maven
• Docker (optional)

Start the Test App

The included test server is a minimal Node.js HTTP server that echoes requests back.

A production-ready WebSocket client/server app using FastAPI.

docker run --rm --name websocket-python-example -p 8080:8080 -it jecklgamis/websocket-python-example:main

Tech Stack

• FastAPI - async web framework with WebSocket support
• websockets - WebSocket client library
• Pydantic v2 - validation and settings management
• Docker - containerized deployment (Python 3.12-slim)
• Helm - Kubernetes deployment chart
• Ruff - linting and formatting
• pytest - testing with async support

Project Structure

├── app/
│   ├── __init__.py        # Global logging init (INFO level)
│   ├── main.py            # FastAPI application entry point
│   ├── config.py          # Environment-specific settings (dev/test/prod)
│   └── routers/           # API route handlers
│       └── websocket.py   # WebSocket /ws endpoint
├── tests/                 # Test suite
├── deployment/
│   └── k8s/helm/          # Helm chart and deploy Makefile
├── websocket_client.py    # WebSocket client
├── run-server.sh          # Start the server
├── run-client.sh          # Start the client
├── Dockerfile
├── Makefile
└── pyproject.toml

Getting Started

Prerequisites

• Python 3.12+
• uv (recommended)
• Docker (for containerized deployment)

# Clone the repository
git clone git@github.com:jecklgamis/websocket-python-example.git && cd websocket-python-example

# Install dependencies
make install-deps

# Start the dev server (uses .env.dev by default)
make run-dev

The server will be available at http://localhost:8080. This will reload on file changes.