azerite

Ports of WoW (World of Warcraft) addon serialization formats from Lua to JavaScript, Python, and Ruby.

Decode and re-encode export strings from WeakAuras, ElvUI, Plater, MDT, VuhDo, Cell, BigWigs, GSE, TotalRP3, DBM, and more.

const { Pipeline } = require('azerite');
const result = Pipeline.decode('!WA:2!nZ...');
// result.data, result.addon, result.steps
Pipeline.encode(result);

require "azerite"
result = Pipeline.decode("!WA:2!nZ...")
Pipeline.encode(result)

from azerite import Pipeline
result = Pipeline.decode("!WA:2!nZ...")
Pipeline.encode(result)

The pipeline auto-detects the addon format from the prefix and data characteristics. See FORMATS.md for full details.

Each language has parallel implementations of:

make install  # install dependencies for all languages
make test     # run all test suites

Or individually:

make test-js      # Node.js (node --test)
make test-ruby    # RSpec
make test-python  # pytest
make test-lua     # busted (Lua reference tests)

Tests are generated from a shared YAML manifest (testing/tests.yaml) using Jinja2 templates, ensuring identical coverage across all languages.

make generate-tests  # regenerate test files from templates

js/              JavaScript package (CommonJS)
ruby/            Ruby gem (lib/azerite/)
python/          Python package (azerite/)
lua/             Lua reference implementations + test suite
testing/         Test code generator, YAML manifest, and Jinja2 templates

• PROTOCOL.md -- AceSerializer and LuaDeflate wire format specification
• FORMATS.md -- Per-addon export format documentation

From-scratch implementations of the wire formats used by these WoW Lua libraries:

• LibDeflate by Haoqian He — EncodeForPrint encoding (zlib)
• AceSerializer-3.0 (Ace3) — type-prefixed text serialization (BSD)
• LibSerialize by Ross Nichols — binary serialization with back-references (MIT)
• LibCompress by jjsheets and Galmok — Huffman + LZW compression (GPL v2)
• VuhDo — custom type-length-value serialization (All Rights Reserved)

ISC