Binary Viewer

A NodeJS module to pretty view binary content.

Requires NodeJS 10.3+.

Example usage:

``js
const { FormatStringParser, BinaryContentFormatter, TextPrinter } = require('binary-viewer');

// A format string describing the binary data.
const formatString =

Hello {
uint8 x;
uint8 y; // format strings can have comments
};

Vertex {
Hello a;
Hello b;
};

/*
Multline comments are supported too.
Yay.
*/

Main {
uint32 count;
uint8 values[count];
int32 foo;
Vertex data[2];
float myfloat;
};

root = Main;

;

// Parse the format string into an AST. Syntactic validation is performed here.
const formatStringAst = new FormatStringParser(formatString).parse();

// Create a binary blob. In a real application this might e.g. be obtained from an API.
const ab = new ArrayBuffer(64);
const dataView = new DataView(ab);
dataView.setUint32(0, 8, true);
dataView.setUint8(4, 10, true);
dataView.setUint8(5, 20, true);
dataView.setUint8(6, 30, true);
dataView.setUint8(7, 40, true);
dataView.setUint8(8, 50, true);
dataView.setUint8(9, 60, true);
dataView.setUint8(10, 70, true);
dataView.setUint8(11, 80, true);
dataView.setInt32(12, 2, true);
dataView.setUint8(16, 5, true);
dataView.setUint8(17, 15, true);
dataView.setUint8(18, 25, true);
dataView.setUint8(19, 35, true);
dataView.setUint8(20, 6, true);
dataView.setUint8(21, 16, true);
dataView.setUint8(22, 26, true);
dataView.setUint8(23, 36, true);
dataView.setFloat32(24, 7294.33, true);

// Interpret the binary blob using the format AST we parsed earlier. Throws on error.
const binaryContentAst = new BinaryContentFormatter(formatStringAst, dataView).read();

// Return the interpreted binary blob as a nicely indented text string.
const textContent = new TextPrinter(binaryContentAst, {spacer: ' ', assignment: ': '}).print();

/*
textContent is a string with the following content:

Main {
uint32 count: 8;
uint8 values[8]: [
10,
20,
30,
40,
50,
60,
70,
80
];
int32 foo: 2;
Vertex data[2]: [
Vertex {
Hello a: {
uint8 x: 5;
uint8 y: 15;
};
Hello b: {
uint8 x: 25;
uint8 y: 35;
};
};
Vertex {
Hello a: {
uint8 x: 6;
uint8 y: 16;
};
Hello b: {
uint8 x: 26;
uint8 y: 36;
};
};
];
float myfloat: 7294.33;
};

*/
`

The src/test/examples/examples.test.ts file contains more examples.

Building

If the pegjs grammar file (src/main/parser.pegjs`) hasn't been changed, run the following:

$ npm run build

If the pegjs grammar file has been changed, run the following:

$ npm run pegjs
$ npm run build

Tests

Run the unit tests as follows:

$ npm run test