serde-llsd

Serialization library for Linden Lab Serial Data format. Rust/Serde version.

Linden Lab Structured Data (LLSD) serialization

This is a serialization system used by Second Life and Open Simulator. It is documented here: http://wiki.secondlife.com/wiki/LLSD

Introduction

There are three formats - XML, binary, and "Notation". All store the same data, which is roughly the same as what JSON can represent. Parsing and output functions are provided.

Status

Preliminary, but appears to work.

XML and binary versions are implemented. "Notation" will not be implemented at this time.

Unit tests pass. Tested against Second Life asset servers and Open Simulator servers. Used by the Sharpview metaverse viewer.

Data types

Boolean - converts to Rust "bool".
Integer - Rust i32.
Real - Rust f64
UUID - Rust [u8;16]
String - Rust String, Unicode
Date - "an absolute point in time, UTC, with resolution to the second", as Rust i64.
URI - Rust String that is a URI
Binary - Vec
A map is a HashMap mapping String keys to LLSD values.
An array is a Rust Vec of LLSD values.

Field access

The enum_as_inner crate is used to derive access functions for each field type. So, given an LLSDValue llsdval which is expected to be an Integer,

let n = *llsdval.as_integer().unwrap();

will yield the integer value.

LLSD values in Rust