The API mocking server for microservice environments
Project description
Mockintosh, the API mocking server for microservice environments
About
Mockintosh aims to provide usual mock service functionality with small resource footprint, making it friendly for microservice applications. You can have tens of mocks at once, inside moderate laptop or single Docker container. Also, we have some additional ideas on how to make mocks simple and useful.
Key features:
- multiple services mocked by a single instance of Mockintosh
- lenient configuration syntax
- performance testing supported
Quick Start
If you have installed Mockintosh as Python package, start it with JSON/YAML configuration file as parameter:
mockintosh my_mocks.yaml
After server starts, you can issue requests against it.
Alternatively, you can run Mockintosh as Docker container:
docker run -it -p 8000-8005:8000-8005 -v `pwd`:/tmp mockintosh:latest /tmp/config.json
Please note the -p
flag used to publish container ports and -v
to mount directory with config into container.
Build
Installing it directly:
pip3 install .
or as a Docker image:
docker build --no-cache -t mockintosh .
To verify the installation run mockintosh
and visit http://localhost:8001
you should be seeing the hello world
response.
Run
Running directly:
mockintosh tests/configs/json/hbs/common/config.json
or as a Docker container:
docker run -p 8000-8010:8000-8010 -v `pwd`/tests/configs/json/hbs/common/config.json mockintosh /config.json
# or
docker run --network host -v `pwd`/tests/configs/json/hbs/common/config.json mockintosh /config.json
Command-line Arguments
The list of command-line arguments can be seen by running mockintosh --help
.
If no configuration file is provided mockintosh
starts with the default config shown below:
{
"services": [
{
"comment": "Default Mock Service Config",
"hostname": "localhost",
"port": 8001,
"endpoints": [
{
"path": "/",
"method": "GET",
"response": "hello world"
}
]
}
]
}
Mockintosh also supports piping config text into its stdin
like:
cat tests/configs/json/hbs/common/config.json | mockintosh
--debug
option enables Tornado Web Server's debug mode.
Using --quiet
and --verbose
options the logging level can be changed.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.