https://github.com/svenstaro/dummyhttp

Super simple HTTP server that replies a fixed body with a fixed response code
https://github.com/svenstaro/dummyhttp

dummy fake http http-server mocking server testing

Last synced: about 4 hours ago
JSON representation

Super simple HTTP server that replies a fixed body with a fixed response code

• Host: GitHub
• URL: https://github.com/svenstaro/dummyhttp
• Owner: svenstaro
• License: mit
• Created: 2018-06-09T13:44:35.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-09-03T23:41:49.000Z (30 days ago)
• Last Synced: 2024-09-23T02:36:29.728Z (11 days ago)
• Topics: dummy, fake, http, http-server, mocking, server, testing
• Language: Rust
• Size: 1.19 MB
• Stars: 97
• Watchers: 3
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# dummyhttp

[![CI](https://github.com/svenstaro/dummyhttp/workflows/CI/badge.svg)](https://github.com/svenstaro/dummyhttp/actions)

[![Docker Hub](https://img.shields.io/docker/pulls/svenstaro/dummyhttp)](https://cloud.docker.com/repository/docker/svenstaro/dummyhttp/)

[![Crates.io](https://img.shields.io/crates/v/dummyhttp.svg)](https://crates.io/crates/dummyhttp)

[![license](http://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/svenstaro/dummyhttp/blob/master/LICENSE)

[![Lines of Code](https://tokei.rs/b1/github/svenstaro/dummyhttp)](https://github.com/svenstaro/dummyhttp)

**A super simple HTTP server that replies with a fixed body and a fixed response code**

This is a simple, small, self-contained, cross-platform CLI tool for debugging

and testing.

It allows you to return arbitrary HTTP responses and log incoming request data.

HTTP/2 support included.

## How to use

### Log all incoming request data

Running `dummyhttp -vv` results in this neat output:

![Pretty log](pretty_log.png)

### Running with no arguments always returns 200 on all interfaces at port 8080

    dummyhttp

    curl -v localhost:8080

    # < HTTP/1.1 200 OK

    # < content-length: 10

    # < date: Sat, 09 Jun 2018 13:56:14 GMT

    # <

    # dummyhttp

### Always emit 400 Bad Request

    dummyhttp -c 400

    curl -v localhost:8080

    # < HTTP/1.1 400 Bad Request

    # < content-length: 10

    # < date: Sat, 09 Jun 2018 13:57:53 GMT

    # <

    # dummyhttp

### Always return a certain string

    dummyhttp -b "Hello World"

    curl -v localhost:8080

    # < HTTP/1.1 200 OK

    # < content-length: 12

    # < date: Sat, 09 Jun 2018 13:58:57 GMT

    # <

    # Hello World

### Return a specific header

    dummyhttp -b '{"Hello": "World"}' -H "content-type:application/json"

    curl -v localhost:8080

    # < HTTP/1.1 200 OK

    # < content-type: application/json

    # < date: Wed, 24 Aug 2022 00:55:35 +0200

    # < content-length: 18

    # <

    # {"Hello": "World"}

## How to install

**Static builds**: These offered for **Linux**, **OSX**, and **Windows** in various architectures over at the [the releases page](https://github.com/svenstaro/dummyhttp/releases).

Grab a binary corresponding to your architecture.

On Linux and OSX, you need to run `chmod +x` on the binary to be able to run it. For example:

    chmod +x dummyhttp-1.0.2-x86_64-unknown-linux-musl

Afterwards, you can run it:

    ./dummyhttp-1.0.2-x86_64-unknown-linux-musl

**With Cargo**: If you have a somewhat recent version of Rust and Cargo installed, you can run

    cargo install dummyhttp

    dummyhttp

## Full options

    Super simple HTTP server that replies with a fixed body and a fixed response code

    Usage: dummyhttp [OPTIONS]

    Options:

      -q, --quiet

              Be quiet (log nothing)

      -v, --verbose...

              Be verbose (log data of incoming and outgoing requests). If given twice it will also log the body data

      -p, --port 

              Port on which to listen

              [default: 8080]

      -H, --headers 

              Headers to send (format: key:value)

      -c, --code 

              HTTP status code to send


              [default: 200]

      -b, --body 

              HTTP body to send

              Supports Tera-based templating (https://tera.netlify.app/docs/) with a few additional

              functions over the default built-ins:

              uuid() - generate a random UUID

              lorem(words) - generate `words` lorem ipsum words

              Example: dummyhttp -b "Hello {{ uuid() }}, it's {{ now() | date(format="%Y") }} {{ lorem(words=5)}}"

              [default: dummyhttp]

      -i, --interface 

              Interface to bind to

              [default: 0.0.0.0]

      -d, --delay 

              Delay in milliseconds before sending the response in milliseconds

              [default: 0]

          --print-completions 

              Generate completion file for a shell

              [possible values: bash, elvish, fish, powershell, zsh]

          --print-manpage

              Generate man page

          --tls-cert 

              TLS certificate to use

          --tls-key 

              TLS private key to use

      -h, --help

              Print help (see a summary with '-h')

      -V, --version

              Print version

## Releasing

This is mostly a note for me on how to release this thing:

- Make sure `CHANGELOG.md` is up to date.

- `cargo release `

- `cargo release --execute `

- Releases will automatically be deployed by GitHub Actions.

- Update Arch package.