PyMockit

Instant mock APIs from a schema file — no server code required.

pymockit run schema.json

In seconds you have a fully functional FastAPI mock server with Swagger UI, realistic fake data, and hot-reload.

Install

pip install pymockit
# or with uv
uv add pymockit

Quick start

# 1. Generate a starter schema
pymockit init

# 2. Start the mock server
pymockit run schema.json

# 3. With hot-reload and a custom port
pymockit run schema.json --port 8080 --reload

# 4. Validate without starting
pymockit validate schema.json

Schema format

{
  "routes": [
    {
      "path": "/users",
      "method": "GET",
      "_status": 200,
      "body": {
        "id": "@faker.uuid4",
        "name": "@faker.name",
        "email": "@faker.email",
        "age": "@faker.random_int",
        "company": "@faker.company"
      }
    },
    {
      "path": "/users/{id}",
      "method": "GET",
      "_status": 200,
      "body": { "id": "@faker.uuid4", "name": "@faker.name" }
    },
    {
      "path": "/products",
      "method": "POST",
      "_status": 201,
      "body": { "created": true, "product_id": "@faker.uuid4" }
    },
    {
      "path": "/broken",
      "method": "GET",
      "_status": 404,
      "body": { "error": "Resource not found" }
    }
  ]
}

Rules

Commands

pymockit run <schema>

Start the mock server.

pymockit init

Create a schema.json starter in the current directory.

pymockit validate <schema>

Check a schema for errors without starting the server. Exits 0 on success, 1 on error.

License

MIT