4 releases (2 breaking)

0.3.2 Jun 1, 2024
0.3.1 May 31, 2024
0.3.0 May 31, 2024
0.2.0 May 31, 2024
0.1.0 May 30, 2024

#9 in #marshal

Download history 99/week @ 2024-07-22 38/week @ 2024-07-29 31/week @ 2024-08-05 30/week @ 2024-08-12 2/week @ 2024-08-19 9/week @ 2024-08-26 10/week @ 2024-09-09 3/week @ 2024-09-16 16/week @ 2024-09-23 20/week @ 2024-09-30 67/week @ 2024-10-14 13/week @ 2024-10-21 13/week @ 2024-10-28 29/week @ 2024-11-04

122 downloads per month
Used in alox-48

MPL-2.0 license

29KB
572 lines

alox-48

alox-48 (short for aluminum oxide 48) is a crate for deserializing and serializing as well Ruby's Marshal data format, using a custom data format like serde.

alox-48 intends to provide almost perfect round-trip deserialization, with some exceptions:

  • Object links are not preserved. Object links are a way for Ruby to compact data in Marshal. They rely heavily on Ruby having a GC and thus do not map well to Rust.
  • Bignum is unsupported.

Why a custom data format

Originally this crate relied on nightly to extend serde, using min_speciailization. Unfortunately that had many shortcomings and the deserializer would frequently choke on valid inputs and the serializer would spit out invalid data.

Most issues revolved around symbols- ruby uses @ prefixed symbols for instance variables, but also accepts variables without the prefix, silently discarding them.

I'm working on a separate serde adapter that can interface serde's data format with alox's, but that looks like it'll be nightly only.

Dependencies

~1–1.5MB
~33K SLoC