pymockit 0.1.0

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

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

Feature	Description
@faker.<method>	Any Faker method — resolved fresh per request
_status	HTTP status code (default 200)
{param}	Path parameters passed through to FastAPI
Literal values	Strings, numbers, booleans, arrays — returned as-is

---

Commands

pymockit run <schema>

Start the mock server.

Option	Default	Description
--host	127.0.0.1	Bind address
--port	8000	TCP port
--reload	off	Restart on schema file change

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