Navigator Prefabricating Marinates
Miss any of our Open RFC calls?Watch the recordings here! »

node-weakauras-parser

3.1.0 • Public • Published

node-weakauras-parser

Installation

npm install node-weakauras-parser
# or 
yarn add node-weakauras-parser

The package is pre-built for the following environments (Haswell is used as the target arch):

OS Node 10 Node 12 Node 13 Node 14
Linux glibc (x86_64) ✔️ ✔️ ✔️ ✔️
Linux musl-libc (x86_64) ✔️ ✔️ ✔️ ✔️
macOS (x86_64) ✔️ ✔️ ✔️ ✔️
Windows (x86_64) ✔️ ✔️ ✔️ ✔️

If you use something else, you will need Rust and zlib in order to build from source code.

If you are getting SIGILL, your CPU does not support some of the instructions that Haswell does. To fix that, you will have to build from source code.

Usage

Non-blocking version:

const parser = require('node-weakauras-parser');
 
(async function() {
    const source = { test: 1 };
    const encoded = await parser.encode(source);
    const decoded = await parser.decode(encoded);
 
    console.log(JSON.stringify(source) === JSON.stringify(decoded));
}());

Blocking version (slightly faster, but blocks the event loop):

const parser = require('node-weakauras-parser');
 
const source = { test: 1 };
const encoded = parser.encodeSync(source);
const decoded = parser.decodeSync(encoded);
 
console.log(JSON.stringify(source) === JSON.stringify(decoded));

Both decode() and decodeSync() accept an optional argument to configure the memory usage limit for decompression (in bytes). Default value is 8 MBs. You can pass +Infinity to disable it.

Known issues

  • Table references from LibSerialize are not fully supported. For example, self-referential tables (or tables referencing an ancestor) will cause an error. As far as I know, those cannot be stored in SavedVariables.lua, so it shouldn't be an issue with WA strings.

Major changes

v3.1

  • encode() now uses a new serialization algorithm adopted by WA in v2.18.

v3

  • encode() and decode() in v2 still spent majority of their time on the main thread, thus blocking the event loop. This is no longer the case but infinite numbers are no longer supported;
  • Functions now return proper Error objects instead of strings.

v2

  • encode() and decode() are now non-blocking;
  • Old, blocking, implementations are available as encodeSync() and decodeSync().

License

The project is licensed under MIT License, unless stated otherwise in a source file.

Install

npm i node-weakauras-parser

DownloadsWeekly Downloads

151

Version

3.1.0

License

MIT

Unpacked Size

140 kB

Total Files

41

Last publish

Collaborators

  • avatar