skip to navigation
skip to content

mock-server 0.3.1

Simple mock server for REST API

Latest Version: 0.3.7

Mock server

Simple mock server for REST and XML-RPC API

It can mock GET, POST, PUT, PATCH, DELETE and some more rarely used HTTP methods.

Build status at Travis CI:


Install with pip:

$ pip install mock-server

Or install with easy_install:

$ easy_install mock-server

And after run:

$ mock-server --dir=/path/to/api

It will be listening on port 8888 and wait for your HTTP requests.


For create mock for url path go to:

Mocked GET /user/tom:

$ curl -v -X GET

> GET /user/tom HTTP/1.1
> Host:
> Accept: */*
< HTTP/1.1 200 OK
< Access-Control-Allow-Origin: *
< Content-Type: application/json; charset=utf-8
< Content-Length: 64
< Server: TornadoServer/2.4.1
    "name": "Tom",
    "surname": "Smith",
    "age": 22


  • Mocking REST API.
  • Mocking RPC API (xml, json).
  • Upstream server proxy (proxy an existing api).
  • Variables in url path.
  • Simple api documentation (markdown).
  • Api authentication (HTTP Basic authentication).


response content format: %METHOD%_%STATUS%.%FORMAT%

response headers format: %METHOD%_H_%STATUS%.%FORMAT%

    GET_200.json         # response content for GET /
    GET_H_200.json       # headers for GET /
        DELETE_404.xml   # response content for DELETE /user.xml?__statusCode=404
        POST_200.json    # response content for POST /user
        POST_H_200.json  # headers for POST /user

Bug report

If you have any trouble, report bug at GitHub Issue



  • support for todos in api documentation
  • access log improvements


  • upstream server proxy (proxy an existing api)
  • variables in url path
  • simple api documentation (markdown)
  • api authentication (HTTP Basic authentication)
  • manage interface improvements

No notes on earlier releases.

File Type Py Version Uploaded on Size
mock-server-0.3.1.tar.gz (md5) Source 2013-06-23 442KB
  • Downloads (All Versions):
  • 54 downloads in the last day
  • 178 downloads in the last week
  • 961 downloads in the last month