Rust Erl Ext

Erlang external term format parser/serializer for Rust.

Examples

Decoding

```rust extern crate erlext; use erlext::Decoder;

fn main() { let mut decoder = Decoder::new(&mut io::stdin()); assert!(true == decoder.readprelude().unwrap()); println!("{}", decoder.decodeterm().unwrap()); } ```

Encoding

```rust extern crate erlext; use erlext::{Eterm, Encoder};

fn main() { let term = Eterm::List(vec!(Eterm::SmallInteger(1), Eterm::Integer(1000000), Eterm::Nil)); // this combination of options make it compatible with erlang:termtobinary/1 let utf8atoms = false; let smallatoms = false; let fairnewfun = true; let mut encoder = Encoder::new(&mut io::stdout(), utf8atoms, smallatoms, fairnewfun); encoder.writeprelude(); encoder.encodeterm(term); } ```

More examples are in examples directory.

Types (all Erlang 17.1 types are supported):

• SmallInteger (u8) : 0..255
• Integer (i32) : integer()
• Float (f64) : float()
• Atom (String) : atom()
• Reference : reference() erlang:make_ref/0
• Port : port() eg, socket or raw file or erlang:open_port/2
• Pid : pid()
• Tuple (Vec<Eterm>) : { any() }
• Map (Vec<(Eterm, Eterm)>) : #{any() := any()}
• Nil : []
• String (Vec<u8>) : [0..255]
• List (Vec<Eterm>) : [ any() ]
• Binary (Vec<u8>) : binary()
• BigNum (BigInt) : integer() > i32
• Fun : fun(..) -> ... end. - deprecated variant
• NewFun : fun(..) -> ... end.
• Export : fun my_mod:my_fun/1
• BitBinary : <<128, 128:4>>

TODO

• serialize::Decoder and serialize::Encoder implementations (not so easy for containers)
• Quick-Check - like tests (feed pseudo-random bytes to decoder, feed random Eterm's to encoder)

Keywords

• Rust
• Erlang
• BERT
• External term format
• termtobinary, binarytoterm
• parser, serializer