1 unstable release
Uses old Rust 2015
0.1.0 | Nov 11, 2016 |
---|
#61 in #erlang
43KB
1.5K
SLoC
bert-rs
BERT (Binary ERlang Term) serializer
This crate provide an access to serializing data to the special binary data format, which can be send to your Erlang programs. The implementation relies on the BERT and Erlang External Term Format specifications.
Dependencies
[dependencies]
serde = "0.8.7"
num = "0.1.34"
byteorder = "0.5.3"
[dev-dependencies]
serde_macros = "0.8.*"
Using
Before you start working with this library you will need to add a link to the bert-rs library at your Cargo.toml file:
[dependencies]
bert = "0.1.0"
License
The bert-rs published under BSD license. For more details read LICENSE file.
Example of using
The bert-rs crate provide a support for default Rust types and some additional, which have specified in BERT document. For any supported type of data which should be serialized you will pass into term_to_binary
function:
#![feature(proc_macro)]
extern crate bert;
extern crate serde;
#[derive(Debug, PartialEq, Serialize)]
struct Point2D(i32, i32);
fn main() {
let point = Point2D(1, 2);
// serialized to {point2d, 1, 2} in BERT format
let serialized_point_2d = bert::term_to_binary(&point).unwrap();
assert_eq!(
serialized_point_2d
vec![
131u8,
105, // tuple
0, 0, 0, 3, // length
100, 0, 7, 112, 111, 105, 110, 116, 50, 100, // "point2d" as atom
98, 0, 0, 0, 1, // 1
98, 0, 0, 0, 2 // 2
]
);
}
Note: At the moment bert-rs provide only serialize features. But bert-rs have the serder-rs-deserializer
branch, where this library provide deserialize functionality. The part of required stuff is not implemented (because of issues with too complicated approaches of deserializing): list, tuples, BertBigInteger
and special kind of tuples which represented as {bert, ...}
. If you want to help in further development, then feel free to open pull requests and issues.
For development used:
- rustup toolchain
- stable
rustc 1.11.0 (9b21dcd6a 2016-08-15)
for building releases - unstable
rustc 1.13.0-nightly (3c5a0fa45 2016-08-22)
for testing
Dependencies
~1MB
~17K SLoC