databind.core

What it is and what it does

Databind is a dataclass (de)serialization framework designed for flexible configuration loading rather than high-performance scenarios. It understands most native Python types—including Enum, Decimal, UUID, Path, datetime, date, time, and timedelta—as well as dataclasses themselves, and can round-trip them to and from JSON-like nested dictionaries. The library supports generic types, multiple union serialization modes, customized type handlers, and field flattening, with runtime type checking during serialization.

The package is configured through settings applied at three levels: globally per load/dump call, as class-level decorators, or inline via type hints using Annotated. It is not intended for scenarios requiring high throughput; the maintainer explicitly recommends other libraries for performance-critical use cases.

Use it for:

• Load application configuration from JSON files into typed dataclass structures with automatic type conversion and validation.
• Serialize dataclass instances back to JSON for storage or API responses with full type awareness.
• Handle complex nested configurations with support for enums, dates, UUIDs, and other non-primitive types.
• Define custom serialization rules per type or field using decorators and Annotated hints.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Deserializes and serializes Python dataclasses and native types to and from JSON-like nested data structures, with support for enums, decimals, UUIDs, paths, datetimes, and generic types.

Yes, if you need flexible dataclass serialization for configuration loading and can tolerate non-optimized performance. The library is actively maintained, permissively licensed, and has low install friction. Note: the package is marked deprecated in favor of the merged 'databind' package; verify whether migration is recommended for new projects.

Install

databind-core on PyPI

pip install databind-core

uv add databind-core

poetry add databind-core

Installing databind.core

Before you install

Low install friction; pure Python wheel. Actively maintained with a release 84 days ago. Supports Python 3.8 and newer.

License in practice

MIT license permits commercial and private use with minimal restrictions—suitable for most projects.

Quickstart

pip install databind-core

from dataclasses import dataclass
from databind.json import load, dump

@dataclass
class Config:
    host: str
    port: int

data = {"host": "localhost", "port": 8080}
config = load(data, Config)
result = dump(config, Config)

Verify before relying

• Whether databind-core is still the recommended entry point or if users should migrate to the merged 'databind' package instead

Package facts

Evidence: databind_core-4.5.5-py3-none-any.whl

Tags

More Software Development packages