adaptix

What it is and what it does

Adaptix is a data model conversion library that transforms dictionaries and JSON into typed Python objects (dataclasses, TypedDict, attrs, SQLAlchemy, Pydantic, msgspec) and back again. It separates model definition from conversion rules, allowing the same model to have different representations without coupling. The library handles dozens of types, supports self-referential structures, provides machine-readable error messages with paths, and offers a predicate system for fine-grained control over conversion behavior.

You create a Retort instance (typically once, as a global or module constant) and call load() to parse incoming data or dump() to serialize objects. It works with no configuration for simple cases but allows extensive customization through predicates and codec options. The library does not auto-cast by default, requiring explicit type matches, which reduces silent errors in data validation pipelines.

Use it for

• Validate and transform received data in REST APIs before passing to business logic.
• Convert between SQLAlchemy ORM models and data transfer objects (DTOs) for API responses.
• Load configuration files (YAML, JSON) into typed dataclass or attrs objects with validation.
• Parse JSON stored in a database and represent it as a strongly-typed model in application code.
• Build API clients that convert local models to JSON for transmission to remote servers.
• Implement a lightweight ORM or object-to-cache mapping for persistence layers.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

adaptix on PyPI

Before you install

Low friction: pure Python wheel with only one runtime dependency (exceptiongroup). Actively maintained with a recent commit on 2026-07-12 and 612 repository stars. Still in beta (3.0.0b12) but documented as production-ready; version pinning is recommended due to potential backward-incompatible changes.

Requires Python 3.10 or later; CPython and PyPy are both supported.

License in practice

Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution in both open-source and proprietary projects with minimal restrictions.

Quickstart

pip install adaptix==3.0.0b12

from dataclasses import dataclass
from adaptix import Retort

@dataclass
class Book:
    title: str
    price: int

retort = Retort()
book = retort.load({"title": "Fahrenheit 451", "price": 100}, Book)
data = retort.dump(book)

Package facts

Evidence: adaptix-3.0.0b12-py3-none-any.whl

Tags

More Python Modules packages

See also dataclass-factory · itemadapter · dataclass-wizard · typed-json-dataclass · datamodel-code-generator · databind · sqlalchemy-serializer · cattrs · dacite · databind.json