secondlife / python-llsd

Python LLSD serialization library

llsd

Official python serialization library for Linden Lab Structured Data (LLSD).

Use

Install llsd with pip:

pip install llsd

Use llsd to parse/format your data:

import llsd

data = {"foo": "bar"}

# Format

data_xml = llsd.format_xml(data)
# >>> '<?xml version="1.0" ?><llsd><map><key>foo</key><string>bar</string></map></llsd>'
data_notation = llsd.format_notation(data)
# >>> "{'foo':'bar'}"
data_binary = llsd.format_binary(data)
# >>> '<?llsd/binary?>\n{\x00\x00\x00\x01k\x00\x00\x00\x03foos\x00\x00\x00\x03bar}'

# Parse

data = llsd.parse(data_xml)
# >>> {'foo: 'bar'}
data = llsd.parse(data_notation)
# >>> {'foo: 'bar'}
data = llsd.parse(data_binary)
# >>> {'foo: 'bar'}

Develop

Requirements:

• pre-commit

Set up a venv and install development dependencies:

python3 -m venv .venv
. .venv/bin/activate
pip install .[dev]

Run tests:

pytest

Benchmarks

Benchmarks from commits to main are published here.

python-llsd's Issues

`format_pretty_xml()` indents badly in a few cases

>>> print(llsd.format_pretty_xml({'ha': ['a', 'b', 'c']}).decode())
<?xml version="1.0" ?>
<llsd>
<map>
    <key>ha</key>
    <array>
      <string>a</string>
      <string>b</string>
      <string>c</string>
</array>
  </map>
</llsd>

This affects autobuild.xml files rewritten by autobuild.