https://github.com/relrin/bert-rs

BERT (Binary ERlang Term) serializer for Rust
https://github.com/relrin/bert-rs

bert erlang rust serde serializer

Last synced: 30 days ago
JSON representation

BERT (Binary ERlang Term) serializer for Rust

• Host: GitHub
• URL: https://github.com/relrin/bert-rs
• Owner: Relrin
• License: bsd-3-clause
• Created: 2016-08-01T14:15:46.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2016-12-04T22:49:10.000Z (almost 8 years ago)
• Last Synced: 2024-08-07T09:25:44.088Z (3 months ago)
• Topics: bert, erlang, rust, serde, serializer
• Language: Rust
• Homepage:
• Size: 78.1 KB
• Stars: 15
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](http://bert-rpc.org/) and [Erlang External Term Format](http://erlang.org/doc/apps/erts/erl_ext_dist.html) specifications.

Dependencies

------------

```toml

[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:

```toml

[dependencies]

bert = "0.1.0"

```

License

-------

The bert-rs published under BSD license. For more details read [LICENSE](https://github.com/Relrin/bert-rs/blob/master/LICENSE) file.

Example of using

----------------

The bert-rs crate provide a support for default Rust types and some additional, which have specified in [BERT](http://bert-rpc.org/) document. For any supported type of data which should be serialized you will pass into `term_to_binary` function:

```rust

#![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