serde_pipe

Crates.ioserde_pipe
lib.rsserde_pipe
version0.1.3
sourcesrc
created_at2018-10-16 14:33:14.432108
updated_at2019-07-26 21:18:35.94426
descriptionTurn serde+bincode into a pipe: push `T`s and pull `u8`s, or vice versa. This library gives you a `Serializer` pipe, into which you can push `T`s and pull `u8`s; and a `Deserializer` pipe, into which you can push `u8`s and pull `T`s.
homepagehttps://github.com/alecmocatta/serde_pipe
repositoryhttps://github.com/alecmocatta/serde_pipe
max_upload_size
id90955
size60,908
Alec Mocatta (alecmocatta)

documentation

https://docs.rs/serde_pipe/0.1.3

README

serde_pipe

Crates.io MIT / Apache 2.0 licensed Build Status

Docs

Turn serde+bincode into a pipe: push Ts and pull u8s, or vice versa.

This library gives you a Serializer pipe, into which you can push Ts and pull u8s; and a Deserializer pipe, into which you can push u8s and pull Ts.

This by default works by allocating a vector to hold the intermediate u8s. However the fringe feature can be enabled, which uses libfringe to turn serde+bincode into a Generator, resulting in bounded memory usage.

Example

use serde_pipe::Serializer;

let large_vector = (0..1u64<<30).collect::<Vec<_>>();
let mut serializer = Serializer::new();
serializer.push().unwrap()(large_vector);

while let Some(pull) = serializer.pull() {
	let byte = pull();
	println!("byte! {}", byte);
}

Note

The fringe feature depends on libfringe, and so enabling it inherits these limitations:

  • Rust nightly is required for the asm and naked_functions features;
  • The architectures currently supported are: x86, x86_64, aarch64, or1k;
  • The platforms currently supported are: bare metal, Linux (any libc), FreeBSD, DragonFly BSD, macOS. Windows is not supported.

License

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 55

cargo fmt