apisprout

README

A simple, quick, cross-platform API mock server that returns examples specified in an API description document. Features include:

• OpenAPI 3.x support
  • Uses operation examples or generates examples from schema
• Load from a URL or local file (auto reload with --watch)
• CORS headers enabled by default
• Accept header content negotiation
  • Example: Accept: application/*
• Prefer header to select response to test specific cases
  • Example: Prefer: status=409
• Server validation (enabled with --validate-server)
  • Validates scheme, hostname/port, and base path
  • Supports localhost out of the box
• Request parameter & body validation (enabled with --validate-request)
• Configuration via:
  • Files (/etc/apisprout/config.json|yaml)
  • Environment (prefixed with SPROUT_, e.g. SPROUT_VALIDATE_SERVER)
  • Commandline flags

Usage is simple:

# Load from a local file
apisprout my-api.yaml

# Validate server name and use base path
apisprout --validate-server my-api.yaml

# Load from a URL
apisprout https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/api-with-examples.yaml

Docker Image

A hosted API Sprout Docker image is provided that makes it easy to deploy mock servers or run locally. For example:

docker pull gcr.io/nebula-contrib/apisprout
docker run -p 8000:8000 gcr.io/nebula-contrib/apisprout http://example.com/my-api.yaml

Configuration can be passed via environment variables, e.g. setting SPROUT_VALIDATE_REQUEST=1, or by passing commandline flags. It is also possible to use a local API description file via Docker Volumes:

# Remember to put the full path to local archive YAML in -v
docker run -p 8000:8000 -v $FULLPATH/localfile.yaml:/api.yaml gcr.io/nebula-contrib/apisprout /api.yaml

Installation

Download the appropriate binary from the releases page.

Alternatively, you can use go get:

go get github.com/puppetlabs/apisprout

Contributing

Contributions are very welcome. Please open a tracking issue or pull request and we can work to get things merged in.

Release Process

We use semantic-release with the ESLint convention to automatically semantically version this package. A push to master creates the appropriate release.

License

Copyright © 2018-2019 Daniel G. Taylor

http://dgt.mit-license.org/