Parrot 🦜

A server to echo back HTTP requests.

Installation

pip install .

Usage

Local Development

Run the server locally:

parrot serve

Configuration

The server can be configured using environment variables or command line options:

Environment Variable	CLI Option	Default	Description
HOST	--host	""	Host to bind to
PORT	--port	8080	Port to run the server on
LOG_FORMAT	--log-format	pretty	Log format (pretty or json)
LOG_LEVEL	INFO	-	Logging level

CLI options take precedence over environment variables.

Docker

Build the container:

docker build -t parrot .

Run the container:

docker run -p 8080:8080 parrot

Kubernetes

Deploy using kubectl:

kubectl apply -f k8s/

Or using Helm:

helm install parrot ./k8s/helm

Endpoints

• GET /health - Health check endpoint with uptime and request count
• ANY /* - Echo back request details

Development

Install development dependencies:

pip install ".[dev]"

Run tests:

pytest

License

MIT