21 releases

0.8.0 Aug 13, 2024
0.7.3 Dec 20, 2023
0.7.2 Oct 27, 2023
0.7.0 Jul 3, 2023
0.3.0 Feb 1, 2021

#620 in Encoding

Download history 15/week @ 2024-07-01 31/week @ 2024-07-08 99/week @ 2024-07-15 48/week @ 2024-07-22 246/week @ 2024-07-29 71/week @ 2024-08-05 273/week @ 2024-08-12 50/week @ 2024-08-19 128/week @ 2024-08-26 40/week @ 2024-09-02 50/week @ 2024-09-09 61/week @ 2024-09-16 110/week @ 2024-09-23 48/week @ 2024-09-30 16/week @ 2024-10-07 43/week @ 2024-10-14

217 downloads per month
Used in 27 crates (26 directly)

Apache-2.0

82KB
1.5K SLoC

destream

Rust library for asynchronous stream (de)serialization


lib.rs:

Provides traits FromStream, Decoder, ToStream and Encoder, which are streaming/async analogues of serde's Deserialize, Deserializer, Serialize, and Serializer.

The structure and contents of this crate are based on serde but not compatible with it (primarily because serde doesn't support async). Most of the code which makes up destream is copied directly from serde with minimal modifications.

serde is dual-licensed under the MIT and Apache-2.0 licenses, which are available at https://github.com/serde-rs/serde/blob/master/LICENSE-MIT and https://github.com/serde-rs/serde/blob/master/LICENSE-APACHE respectively.

Important differences between destream and serde:

  • destream supports decoding from and encoding to a futures::Stream (obviously).
  • destream does not (yet) support the derive macro, so you can't derive FromStream or ToStream, and there is no built-in functionality for decoding/encoding a given struct.
  • Decoder assumes the static lifetime and only supports owned types, but Encoder uses a specific lifetime 'en. This is the opposite of serde.

destream itself does not implement support for any specific serialization format. destream_json provides support for streaming JSON.

Dependencies

~1.5–2.3MB
~45K SLoC