respond

README

Respond

Return a response with the specified status code for any request

Rationale

A http server returning specific status codes is useful for infrastructure testing and development. This is possible using a variety of multi purpose tools (netcat, socat etc..), however its not always immediately obvious what incantation is required to achieve this.

Installation

To run the container image:

# run respond listening on port 8080
docker run -p 8080:8080 sysant/respond

Prebuilt releases are available from the releases page.

Or fetch and build using go install:

go install github.com/amenasse/respond/cmd/respond@latest

Usage

Listen on 8080 and return a 404 status code for all requests:

respond 404

Without any arguments a 200 status code is returned

respond

Respond will bind to port 8080 on all interfaces. A different port and address can be specified:

respond -bind 127.0.0.1 -port 9090

To listen for HTTPS connections provide a private key and cert in PEM format using the key and cert options:

respond -key ./certs/example.com/privkey.pem -cert ./certs/example.com/cert.pem

Response Body

The response body can be customised

respond 200 '{{.Host}} {{.Method}} {{.Path}} {{.Proto}} {{.StatusCode}} {{.Description}}\n'

Request headers can be returned in the response

respond 200 '🕵: {{ .RequestHeader "User-Agent" }}, 👻: {{.RequestHeader "Host"}}'

All header names and values can be returned with .RequestHeaders

respond 200 '{{range .RequestHeaders }}{{.Name}}: {{.Value}}|{{end}}'

Response Headers

Response headers can be set with the header option:

respond -header 'Content-Type: application/json' \
        -header 'Last-Modified: Sun, 13 May 1984 08:52:00 GMT' \
        200 '{"Model" : "T-800", "Processor": "6502"}'

Logging

Logging can be customised with the logformat option:

respond -logformat \
        '{"Method": "{{.Method}}","Path": "{{.Path}}", "Code": "{{.StatusCode}}"}'