PyForge

Rust-accelerated serialization and validation for Python. Drop-in for Django REST Framework, standalone for everything else.

Performance

Measured against DRF ModelSerializer on a 9-field model (CPython 3.12, Django 6.0):

Database query time excluded. Raw dict comprehensions show no benefit — PyForge replaces DRF, not Python itself.

Install

pip install pyforge-django        # Django projects
pip install pyforge-core           # Any Python project

Add to INSTALLED_APPS: "django_pyforge"

Django Quickstart

# Add to any existing DRF serializer — one line change
from django_pyforge.serializers import RustSerializerMixin

class MySerializer(RustSerializerMixin, serializers.ModelSerializer):
    class Meta:
        model = MyModel
        fields = "__all__"

# Check which serializers benefit:
# python manage.py pyforge_doctor

Python Quickstart

from dataclasses import dataclass
from pyforge_core import from_dataclass, serialize

@dataclass
class User:
    name: str
    age: int
    email: str

schema = from_dataclass(User)
result = serialize({"name": "Erik", "age": 30, "email": "erik@x.com"}, schema)

What's New in v0.3.0

• serialize_values_list() — single Rust call for entire querysets (3.5x over DRF)
• pyforge_doctor — audit which serializers benefit (--app, --json, --threshold)
• from_dataclass() / from_typeddict() — auto-generate Schema from type hints
• PyForgeMetricsMiddleware — X-PyForge-Stats header per request
• N+1 detection — warns on missing select_related during serialization
• serialize_stream() — constant-memory streaming for large exports
• Schema validation — catches invalid Field() constraints at definition time

Supported Django Fields

When PyForge Helps

• DRF list views returning 50+ records
• Bulk create/update with validation
• Export jobs processing thousands of records
• High-traffic APIs where serialization is the bottleneck

When PyForge Does NOT Help

• Raw dict comprehensions or .values() without DRF
• Single-record detail views (bridge overhead ~10us)
• Database-bound views — PyForge does not touch query time

Requirements

• Python 3.11+ — no Rust installation needed (pre-built wheels)
• Django 4.2 LTS or 5.x (for pyforge-django)
• Any Python project (for pyforge-core)

License

MIT — Abdulwahed Mansour