clarax 1.0.0

When to Use ClaraX

ClaraX replaces DRF's serialization and validation overhead, not Python itself. Use this decision guide:

Use ClaraX (Django)

Do NOT Use ClaraX

Quick Check

# Run on your Django project — tells you exactly which serializers benefit
python manage.py clarax_doctor --json

Performance

Django (clarax-django vs DRF ModelSerializer)

Measured on a 17-field model, CPython 3.12, SQLite:

Standalone (clarax-core, 50K records)

Python 3.14 Free-Threading

ClaraX supports Python 3.14t (no-GIL) with zero code changes. Rayon parallel operations use all CPU cores:

Install

pip install clarax-django        # Django projects
pip install clarax-core           # Any Python project (Flask, FastAPI, scripts)

Add to INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    "django_clarax",
]

Django Quickstart

Step 1: Add the mixin (one line)

from django_clarax.serializers import RustSerializerMixin

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

Step 2: Check your project

python manage.py clarax_doctor

Output tells you exactly which serializers benefit and which fields are Rust-accelerated.

Step 3: Use batch APIs for bulk operations

from django_clarax import ModelSchema, serialize_batch, serialize_values_list

schema = ModelSchema(MyModel)

# From model instances (2.7x over DRF)
results = serialize_batch(queryset, schema)

# From values_list (3.5x over DRF, lowest overhead)
results = serialize_values_list(queryset, schema)

# Streaming for large exports (constant memory)
for chunk in serialize_stream(queryset, schema, chunk_size=500):
    yield chunk

Standalone Quickstart (clarax-core)

from clarax_core import Schema, Field, serialize_many, validate_many
from decimal import Decimal

schema = Schema({
    "name": Field(str, max_length=100),
    "age":  Field(int, min_value=0, max_value=150),
    "price": Field(Decimal, max_digits=10, decimal_places=2),
})

data = [{"name": "Erik", "age": 30, "price": Decimal("199.99")}]
serialized = serialize_many(data, schema)
report = validate_many(data, schema)

Batch operations (where Rust dominates)

from clarax_core import validate_names_batch, validate_ids_batch, batch_stats

# Character scanning — 9x over Python
results = validate_names_batch(["Erik Andersson", "Bad123"])

# Pattern matching — 15x over Python
valid = validate_ids_batch(["19900515-1234", "invalid"])

# Statistics — 20x over Python's statistics module
stats = batch_stats([1.0, 2.0, 3.0, 4.0, 5.0])

Supported Django Fields

Requirements

• Python 3.11+ (pre-built wheels, no Rust installation needed)
• Python 3.14t supported (free-threading / no-GIL)
• Django 4.2 LTS or 5.x (for clarax-django)
• Any Python project (for clarax-core)

License

MIT -- Abdulwahed Mansour