dataclass-coder

Lightweight and fast encoder/decoder for dataclass objects.

Installation

pip install dataclass-coder

Quickstart

from dataclasses import dataclass
from datetime import date
from decimal import Decimal
from typing import Optional

from dataclass_coder import DataclassCoder


@dataclass
class NestedField:
    name: str
    decimal_value: Decimal


@dataclass
class Person:
    name: str
    age: int
    birthday: date
    nested_field: Optional[NestedField] = None


person_coder = DataclassCoder(Person,
                              dict_field_decoders={Person: {'birthday': date.fromisoformat}, NestedField: {'decimal_value': Decimal}},
                              json_type_encoders={date: date.isoformat, Decimal: str})


data = '{"name": "High Time", "age": 26, "birthday": "1995-04-01", "nested_field": {"name": "test", "decimal_value": "11.1"}}'

person = person_coder.from_json(data)
print(person)  # Person(name='High Time', age=26, birthday=datetime.date(1995, 4, 1), nested_field=NestedField(name='test', decimal_value=Decimal('11.1')))

person_dict = person_coder.to_dict(person)
print(person_dict)  # {'name': 'High Time', 'age': 26, 'birthday': datetime.date(1995, 4, 1), 'nested_field': {'name': 'test', 'decimal_value': Decimal('11.1')}}

person_json = person_coder.to_json(person)
print(person_json)  # {"name": "High Time", "age": 26, "birthday": "1995-04-01", "nested_field": {"name": "test", "decimal_value": "11.1"}}