pyserde

Yet another serialization library on top of dataclasses, inspired by serde-rs.

Guide🇬🇧 | ガイド🇯🇵 | API Reference | Examples

Overview

pyserde is a simple yet powerful serialization library on top of dataclasses. It allows you to convert Python objects to and from JSON, YAML, and other formats easily and efficiently.

Declare your class with @serde decorator and annotate fields using PEP484 as below.

@serde
class Foo:
    i: int
    s: str
    f: float
    b: bool

You can serialize Foo object into JSON.

>>> to_json(Foo(i=10, s='foo', f=100.0, b=True))
'{"i":10,"s":"foo","f":100.0,"b":true}'

You can deserialize JSON into Foo object.

>>> from_json(Foo, '{"i": 10, "s": "foo", "f": 100.0, "b": true}')
Foo(i=10, s='foo', f=100.0, b=True)

That's it! If you're interested in pyserde, please check our documentation! Happy coding with pyserde! 🚀

• Getting started
• API Reference
• Examples

Features

• Supported data formats
  • dict
  • tuple
  • JSON
  • Yaml
  • Toml
  • MsgPack
  • Pickle
• Supported types
  • Primitives (int, float, str, bool)
  • Containers
    • list, collections.abc.Sequence, collections.abc.MutableSequence, tuple
    • set, collections.abc.Set, collections.abc.MutableSet
    • dict, collections.abc.Mapping, collections.abc.MutableMapping
    • frozenset, defaultdict, deque, Counter
  • typing.Optional
  • typing.Union
  • User defined class with @dataclass
  • typing.NewType for primitive types
  • typing.Any
  • typing.Literal
  • typing.Generic
  • typing.ClassVar
  • dataclasses.InitVar
  • Enum and IntEnum
  • Standard library
    • pathlib.Path
    • decimal.Decimal
    • uuid.UUID
    • datetime.date, datetime.time, datetime.datetime
    • ipaddress
  • PyPI library
    • numpy types
    • SQLAlchemy Declarative Dataclass Mapping (experimental)
• Class Attributes
• Field Attributes
• Decorators
• Type Check
• Union Representation
• Forward reference
• PEP563 Postponed Evaluation of Annotations
• PEP585 Type Hinting Generics In Standard Collections
• PEP604 Allow writing union types as X | Y
• PEP681 Data Class Transform
• PEP695 Type Parameter Syntax
• PEP747 Annotating Type Forms
• Case Conversion
• Rename
• Alias
• Skip (de)serialization (skip, skip_if, skip_if_false, skip_if_none, skip_if_default at field or class level)
• Custom field (de)serializer
• Custom class (de)serializer
• Custom global (de)serializer
• Flatten

Extensions

• pyserde-timedelta: (de)serializing datetime.timedelta in ISO 8601 duration format.

Contributors ✨

Thanks goes to these wonderful people:

Made with contrib.rocks.

LICENSE

This project is licensed under the MIT license.