json-text-sequence
TypeScript icon, indicating that this package has built-in type declarations

2.0.2 • Public • Published

json-text-sequence

Parse and generate JSON text sequences as defined in RFC 7464.

JSON text sequences are nice for unambiguous JSON log files. They are resilient to many forms of damage such as truncation, multiple writers incorrectly configured to write to the same file, corrupted JSON, etc. An example sequence:

␞{"d":"2014-09-22T21:58:35.270Z","value":6}␤
␞{"d":"2014-09-22T21:59:15.117Z","value":12}␤

Where "␞" is the ASCII "Record Separator" character (U+001E), and "␤" is the ASCII "LINE FEED" character (U+000A), otherwise known as "\n".

Installation

npm install json-text-sequence

API

Parsing

To parse the format, pipe an input source into a parser stream:

import {Parser} from 'json-text-sequence'
import fs from 'fs'

const p = new Parser()
  .on('data', obj => {
    console.log('JSON:', obj);
  })
  .on('truncated', buf => {
    console.log('Truncated:', buf);
  })
  .on('invalid', buf => {
    console.log('Invalid:', buf);
  })
  .on('finish', () => {
    console.log('DONE');
  });

fs.createReadStream('example.log').pipe(p);

Generation

To generate the format, create a generator, pipe its output somewhere interesting, then write objects to the generator:

import {Generator} from 'json-text-sequence'
import fs from 'fs'

const g = new Generator();
g.pipe(fs.createWriteStream('example.log'));

g.write({
  d: new Date(),
  count: 0
});

Tests Coverage Status

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 2.0.2
    17
    • latest

Version History

Package Sidebar

Install

npm i json-text-sequence

Weekly Downloads

48,766

Version

2.0.2

License

MIT

Unpacked Size

8.4 kB

Total Files

5

Last publish

Collaborators

  • hildjj