Source

scheme-bert / README.markdown

Full commit

scheme-bert

scheme-bert is a BERT (Binary ERlang Term) serialization library for Scheme implementations compliant to R^6RS. BERT is based on Erlang's External Term Format.

See the BERT specification at bert-rpc.org.

Instances of the following Scheme types will be automatically converted to the proper simple BERT type:

  • flonum?
  • integer? (fixnum and bignum)
  • symbol?
  • list?
  • string?
  • vector?

Instances of the following Scheme types will be automatically converted to the proper complex BERT type:

  • 'nil
  • #t
  • #f
  • hashtable?
  • time?

Installation

Installation for Racket:

$ plt-r6rs --install ./src/scheme-bert.ss

(see Installing Libraries for more info)

Usage

Issue (import (scheme-bert)) in your REPL or put this in head of your source file. You will also probably want to import some other libraries such as bytevectors.

> (bert-encode (vector 'foo 42 666 (vector 12 '() (vector 255 'bar) 111222333444555666)))
#"\203h\4d\0\3fooa*b\0\0\2\232h\4a\fjh\2a\377d\0\3barn\b\0\222\203\r|\37$\213\1"

> (bert-decode #"\203m\0\0\0001Most people would rather die than think; many do.")
"Most people would rather die than think; many do."

Caveats

Regular expressions conversion is not supported, because evey Scheme comes with its own regexp implementation and I haven't found any portable library which allows to get source regexp after one is compiled.

Trivia

Please, drop me an email to yarsanukaev AT gmail DOT com if you used or intend to use the library in your project ;-)

Copyright (c) 2010 Yasir M. Arsanukaev. See LICENSE for details.