bufrw

bufrw

Buffer Reading and Writing

Example

Simple length-prefixed string:

var bufrw = require("bufrw");

var buf = bufrw.toBuffer(bufrw.str1, "hello world");
// <Buffer 0b 68 65 6c 6c 6f 20 77 6f 72 6c 64>
var str = bufrw.fromBuffer(bufrw.str1, buf)
// "hello world"

// TODO more examples

Concept and Motivation

A combinatoric library for synchronous binary buffer reading and writing.

The design is to combine:

• needed byte length calculation
• writing into a pre-allocated buffer
• reading from a buffer

Into a single re-combinable data type, eventually supporting code generation for efficiency.

Any of those three steps may result in an error, so rather than rely on error throw/catching we use an error-able result type.

API Documentation

See docs.jsig

Installation

npm install bufrw

Tests

npm test

NPM scripts

• npm run add-licence This will add the licence headers.
• npm run cover This runs the tests with code coverage
• npm run lint This will run the linter on your code
• npm test This will run the tests.
• npm run trace This will run your tests in tracing mode.
• npm run travis This is run by travis.CI to run your tests
• npm run view-cover This will show code coverage in a browser

Contributors

• Joshua T Corbin

MIT Licenced

Similar packages

Other packages similar to bufrw

buffer

The 'buffer' package is a core Node.js module that provides a way of handling binary data directly in JavaScript. It is similar to 'bufrw' in that it allows reading and writing of binary data, but it is more general-purpose and does not provide the same level of abstraction for custom serialization.

binary

The 'binary' package provides a declarative way to work with binary data in Node.js. It allows you to define binary structures and parse them from buffers. It is similar to 'bufrw' in that it provides tools for binary data serialization and deserialization, but it uses a different approach with a focus on declarative syntax.

struct

The 'struct' package allows you to define and work with binary data structures in Node.js. It is similar to 'bufrw' in that it provides tools for defining and working with binary data structures, but it offers a different API and focuses on ease of use for defining complex binary structures.