Serialite

Serialite is a library serializing and deserializing arbitrarily complex objects in Python. You apply the @serializable decorator to a dataclass to automatically create to_data and from_data methods using the type annotations. Or for more control, inherit from the SerializableMixin and implement the class attribute __fields_serializer__. For even more control, inherit from the abstract base class Serializer and implement the to_data and from_data methods directly.

Basics

The abstract base class is Serializer:

class Serializer(Generic[Output]):
    def from_data(self, data: Json) -> DeserializationSuccess[Output]: ...
    def to_data(self, value: Output) -> Json: ...

The class is generic in the type of the object that it serializes. The two abstract methods from_data and to_data are the key to the whole design, which revolves around getting objects to and from JSON-serializable data, which are objects constructed entirely of bools, ints, floats, lists, and dicts. Such structures can be consumed by json.dumps to produce a string and produced by json.loads after consuming a string. By basing the serialization around JSON serializable data, complex structures can be built up or torn down piece by piece while alternatively building up complex error messages during deserialization which pinpoint the location in the structure where the bad data exist.

For new classes, it is recommended that the Serializer be implemented on the class itself. There is an abstract base class Serializable that classes can inherit from to indicate this. There is a mixin SerializableMixin that provides an implementation of from_data and to_data for any class that implements the __fields_serializer class attribute.

For dataclasses, it is even easier. There is a decorator serializable that inserts SerializableMixin into the list of base classes after the dataclass decorator has run and also generates __fields_serializer__ from the data class attributes.

Finding the correct serializer for each type can be a pain, so serializer(cls: type) -> Serializer is provided as a convenience function. This is a single dispatch function, which looks up the serializer registered for a particular type. For example, serializer(list[float]) will return ListSerializer(FloatSerializer).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

serialite-0.6.4.tar.gz (26.2 kB view details)

Uploaded Aug 2, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

serialite-0.6.4-py3-none-any.whl (42.0 kB view details)

Uploaded Aug 2, 2026 Python 3

File details

Details for the file serialite-0.6.4.tar.gz.

File metadata

Download URL: serialite-0.6.4.tar.gz
Upload date: Aug 2, 2026
Size: 26.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for serialite-0.6.4.tar.gz
Algorithm	Hash digest
SHA256	`06059e4aa1313cf98acbe057ce3658ccdee379541804c333413a5fab2ed15578`
MD5	`5b525235d688ca965135c8e9f3abd649`
BLAKE2b-256	`b4b47604a713c56c0e54d77237960b0ba3a8e0dd5bb3356ad97c175a72d4c58f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for serialite-0.6.4.tar.gz:

Publisher: release.yml on drhagen/serialite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: serialite-0.6.4.tar.gz
- Subject digest: 06059e4aa1313cf98acbe057ce3658ccdee379541804c333413a5fab2ed15578
- Sigstore transparency entry: 2316265988
- Sigstore integration time: Aug 2, 2026
Source repository:
- Permalink: drhagen/serialite@758670141d50569d5265f1a408ffbdab808b6f37
- Branch / Tag: refs/tags/v0.6.4
- Owner: https://github.com/drhagen
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@758670141d50569d5265f1a408ffbdab808b6f37
- Trigger Event: push