Interoperates dataclasses and TypedDict annotations with json objects for python
Documentation: https://dutradda.github.io/jsondaora
Source Code: https://github.com/dutradda/jsondaora
- Full compatibility with dataclasses module and TypedDict annotation
- Deserialize values from dict
- Deserialize values from bytes*
- Deserialization/serialization of choosen fields
- Dict serialization
- Direct json serialization with orjson (don't convert to dict recursively before serialization)
- Optional validation according with the json-schema specification*
* feature in development.
- Python 3.8+
- orjson for json serialization
$ pip install jsondaora
from typing import List, TypedDict
from jsondaora import (
as_typed_dict,
asdataclass,
dataclass_asjson,
jsondaora,
typed_dict_asjson,
)
@jsondaora
class Person:
name: str
age: int
class Music:
name: str
musics: List[Music]
jsondict = dict(name=b'John', age='40', musics=[dict(name='Imagine')])
person = asdataclass(jsondict, Person)
print('dataclass:')
print(person)
print(dataclass_asjson(person))
print()
# TypedDict
@jsondaora
class Person(TypedDict):
name: str
age: int
class Music(TypedDict):
name: str
musics: List[Music]
jsondict = dict(name=b'John', age='40', musics=[dict(name='Imagine')])
person = as_typed_dict(jsondict, Person)
print('TypedDict:')
print(person)
print(typed_dict_asjson(person, Person))dataclass:
Person(name='John', age=40, musics=[Person.Music(name='Imagine')])
b'{"name":"John","age":40,"musics":[{"name":"Imagine"}]}'
TypedDict:
{'name': 'John', 'age': 40, 'musics': [{'name': 'Imagine'}]}
b'{"name":"John","age":40,"musics":[{"name":"Imagine"}]}'
from typing import List, TypedDict
from jsondaora import (
as_typed_dict,
asdataclass,
dataclass_asjson,
jsondaora,
typed_dict_asjson,
)
@jsondaora(deserialize_fields=('name'))
class Person:
name: str
age: int
class Music:
name: str
musics: List[Music]
jsondict = dict(name=b'John', age='40', musics=[dict(name='Imagine')])
person = asdataclass(jsondict, Person)
print('dataclass:')
print(person)
print(dataclass_asjson(person))
print()
# TypedDict
@jsondaora(deserialize_fields=('name'))
class Person(TypedDict):
name: str
age: int
class Music(TypedDict):
name: str
musics: List[Music]
jsondict = dict(name=b'John', age='40', musics=[dict(name='Imagine')])
person = as_typed_dict(jsondict, Person)
print('TypedDict:')
print(person)
print(typed_dict_asjson(person, Person))dataclass:
Person(name='John', age='40', musics=[{'name': 'Imagine'}])
b'{"name":"John","age":"40","musics":[{"name":"Imagine"}]}'
TypedDict:
{'name': 'John', 'musics': [{'name': 'Imagine'}], 'age': '40'}
b'{"name":"John","musics":[{"name":"Imagine"}],"age":"40"}'
from typing import List, TypedDict
from jsondaora import (
as_typed_dict,
asdataclass,
dataclass_asjson,
jsondaora,
typed_dict_asjson,
)
@jsondaora(serialize_fields=('name', 'age'))
class Person:
name: str
age: int
class Music:
name: str
musics: List[Music]
jsondict = dict(name='John', age=40, musics=[dict(name='Imagine')])
person = asdataclass(jsondict, Person)
print('dataclass:')
print(person)
print(dataclass_asjson(person))
print()
# TypedDict
@jsondaora(serialize_fields=('age'))
class Person(TypedDict):
name: str
age: int
class Music(TypedDict):
name: str
musics: List[Music]
jsondict = dict(name=b'John', age='40', musics=[dict(name='Imagine')])
person = as_typed_dict(jsondict, Person)
print('TypedDict:')
print(person)
print(typed_dict_asjson(person, Person))dataclass:
Person(name='John', age=40, musics=[Person.Music(name='Imagine')])
b'{"age":40,"name":"John"}'
TypedDict:
{'name': 'John', 'age': 40, 'musics': [{'name': 'Imagine'}]}
b'{"age":40}'
Wins Pydantic Benchmark
jsondaora is up to 3.2 times faster than pydantic on it's benchmark
