Skip to main content

Binary serializer for attrs-based classes

Project description


attrs2bin is a Python library that lets you serialize/deserialize your attrs-based classes to/from a byte stream. It is compatible with Rust's bincode, so you can seralize objects in Python, send the resulting byte stream through a socket or any other transport and deserialize it back to a Rust object. It can also deserialize objects from a socket (see below).


attrs2bin provides just two simple funcions: serialize(), which takes an object and returns a byte stream, and deserialize(), that takes a byte stream and an attrs-based class and returns an object.

import attrs2bin

class Sprite:
    name: str
    x: int
    y: int

my_sprite = Sprite("My sprite", 35, 70)
serialized = attrs2bin.serialize(my_sprite)
deserialized = attrs2bin.deserialize(serialized, Sprite)
assert my_sprite == deserialized

What can be serialized?

Objects of any attrs-based class can be serialized, as long as all their fields have a type (using type annotations or attr.ib(type=...)). attrs2bin ships with serializer for the following types:

  • int
  • float
  • bytes
  • str
  • bool

You can create and register your own serializers for specific types by creating a class that implements attrs2bin.interfaces.ITypeSerializer and calling attrs2bin.register_serializer().

Deserializing from a socket

Instead of deserialize(bytes, cls), you can use deserialize_from_socket(sck, cls), which will read the necessary bytes from a socket and return a Python object. sck must be any object that implements attrs2bin.interfaces.IReadableSocket.

Rust compatibility

The serializers that ships with attrs2bin are all compatible with Rust's bincode library. Keep under your pillow the following table in order to create compatible types between Python and Rust:

Python type Rust type
int / attrs2bin.SignedInt i64
attrs2bin.UnsignedInt u64
float / attrs2bin.Float64 f64
attrs2bin.Float32 f32
bytes Vec<u8>
str String
bool bool

Project details

Download files

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

Source Distribution

attrs2bin-0.0.1.tar.gz (4.9 kB view hashes)

Uploaded source

Built Distribution

attrs2bin-0.0.1-py3-none-any.whl (7.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page