Dataclasses JSON

This library provides a simple API for encoding and decoding dataclasses to and from JSON.

It's recursive (see caveats below), so you can easily work with nested dataclasses.

In addition to the supported types in the py to JSON table, any arbitrary Collection type is supported (they are encoded into JSON arrays, but decoded into the original collection types).

The latest release is compatible with both Python 3.7 and Python 3.6 (with the dataclasses backport).

Quickstart

pip install dataclasses-json

Approach 1: Class decorator

from dataclasses import dataclass
from dataclasses_json import dataclass_json

@dataclass_json
@dataclass
class Person:
    name: str

lidatong = Person('lidatong')

# Encoding to JSON
encoded_lidatong = lidatong.to_json()
assert encoded_lidatong == '{"name": "lidatong"}'

# Decoding from JSON
decoded_lidatong = Person.from_json('{"name": "lidatong"}')
assert decoded_lidatong == lidatong

Note that the @dataclass_json decorator must be stacked above the @dataclass decorator (order matters!)

Approach 2: Inherit from a mixin

from dataclasses import dataclass
from dataclasses_json import DataClassJsonMixin

@dataclass
class Person(DataClassJsonMixin):
    name: str

lidatong = Person('lidatong')
assert Person.from_json(lidatong.to_json()) == lidatong

Pick whichever approach suits your taste. The differences in implementation are invisible in usage.

A larger example

from dataclasses import dataclass
from dataclasses_json import DataClassJsonMixin
from typing import List


@dataclass(frozen=True)
class Minion(DataClassJsonMixin):
    name: str


@dataclass(frozen=True)
class Boss(DataClassJsonMixin):
    minions: List[Minion]

boss = Boss([Minion('evil minion'), Minion('very evil minion')])
boss_json = """
{
    "minions": [
        {
            "name": "evil minion"
        },
        {
            "name": "very evil minion"
        }
    ]
}
""".strip()

assert boss.to_json(indent=4) == boss_json
assert Boss.from_json(boss_json) == boss

Caveats

Data Classes that contain forward references (e.g. recursive dataclasses) are not currently supported.

Metadata

Release files for dataclasses-json 0.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dataclasses-json 0.0.13
File	Size	Uploaded
dataclasses-json-0.0.13.tar.gz	4.4 kB	Sep 2, 2018	Details

Built distribution (wheel)

Table of built distributions (wheels) for dataclasses-json 0.0.13
File	Interpreter	ABI	Platform	Reset
dataclasses_json-0.0.13-py3-none-any.whl 4.9 kB Sep 2, 2018	Python 3	none	any	Details

Total release size: 9.3 kB

Release files / dataclasses-json-0.0.13.tar.gz

Download URL	dataclasses-json-0.0.13.tar.gz
Size	4.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`0b56a6a30c3b27ee340faa0f066257f8c428b5495abc93619782f6fe2d101caf`
BLAKE2b-256 checksum How to use checksums	`aa4e9dd8302405319bdace2bc25301af5c49a388a73c44ac6644bd005152843f`
Upload date	Sep 2, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0`

Release files / dataclasses_json-0.0.13-py3-none-any.whl

Download URL	dataclasses_json-0.0.13-py3-none-any.whl
Size	4.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cc1c4dd30fe9296ec7dc6eb2435dd8836d306455cf1a4ce0d044ee9402346c83`
BLAKE2b-256 checksum How to use checksums	`615602d8f4c765cfc7df631380101f42bcdcac6d175e92645dad7d7341fe2ded`
Upload date	Sep 2, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0`