pyfake 0.0.8

A fake data generator that is pydantic compatible.

Pyfake

A flexible, schema-driven fake data generator built on top of Pydantic v2.

---

Docs: mukhopadhyay.github.io/pyfake  •  Source: github.com/Mukhopadhyay/pyfake

---

✨ Why Pyfake?

Most fake data generators are either:

• ❌ Random but not structured
• ❌ Structured but not realistic
• ❌ Hard to extend

Pyfake fixes that.

It leverages Pydantic models as the single source of truth to generate:

• ✅ Validated data
• ✅ Schema-aware fake data
• ✅ Easily extensible generators
• ✅ Strong typing + IDE autocomplete

---

⚡ Quick Example

import uuid
from typing import Annotated
from pydantic import BaseModel, Field
from pyfake import Pyfake


class User(BaseModel):
    id: uuid.UUID = Field(default_factory=uuid.uuid4)
    name: Annotated[str, Field(min_length=3, max_length=20)]
    address: Annotated[str, Field(max_length=255)]
    age: Annotated[int, Field(ge=18)]
    is_deleted: bool


users = Pyfake.from_schema(User, num=5)

print(users)

🧠 How It Works

Pyfake reads your Pydantic schema and:

• Inspects field types and constraints
• Applies intelligent generators
• Produces validated fake data

flowchart LR
    A[Pydantic Model] --> B[Schema Parser]
    B --> C[Generator Engine]
    C --> D[Validated Fake Data]

Installation

Using uv (Recommended)

uv add pyfake

Using pip

python -m venv .venv
source .venv/bin/activate
pip install pyfake