ldjson -- Line Delimited JSON

see http://en.wikipedia.org/wiki/Line_Delimited_JSON

Status

Under development, see TODOs.

Install

npm install ldjson

API

Use it on any readable stream:

var ldjson = require('ldjson');

var stream = ldjson.createDeserialisingStream(your_stream);

ldjson streams fire data events with two arguments. The first is the original JSON string, while the second is the Javascript object.

Convenience API

ldjson can present an API similar to net for TCP client and server functions.

Client

var ldjson = require('ldjson');

var ldjson_socket = ldjson.connect(1337, '127.0.0.1', function() {
  console.log('connected');
});

ldjson_socket.on('data', function(json, ob) {
  console.log('received json:', json);
  console.log('received ob:', ob);
});

Server

var ldjson = require('ldjson');

var server = ldjson.createServer(function (ldjson_socket) {
  console.log('accepted connection');

  var count = 0;
  var interval = setInterval(function() {
    ldjson_socket.write({"count":count++});
  }, 3000);

  ldjson_socket.on('data', function(json, ob) {
    console.log('received json:', json);
    console.log('received ob:', ob);
  });
});

server.listen(1337, '127.0.0.1');

TODOs

• Check handling of invalid JSON.
• Fix pause and resume functionality for wrapped streams.
• Increase test coverage.