lswbxml

lswbxml

Fast streaming WBXML parser and generator for Node.js.

Installation

With npm:

npm install lswbxml

Parsing WBXML

LiveScript:

require! fs
wbxml = require \lswbxml

# With streams
file = fs.create-read-stream 'example.wbxml'
<-! file.on \open
wbxml.decode file, language: \ActiveSync, !(err, obj)->
  throw err if err
  console.log 'Parsed WBXML:'
  console.log obj

# With buffers (synchronous)
buf = fs.read-file-sync 'example.wbxml'
obj = wbxml.decode-sync buf, language: \ActiveSync
console.log 'Parsed WBXML:'
console.log obj

CoffeeScript:

fs = require 'fs'
wbxml = require 'lswbxml'

# With streams
file = fs.createReadStream 'example.wbxml'
file.on 'open', ->
  wbxml.decode file, language: 'ActiveSync', (err, obj)->
    throw err if err
    console.log 'Parsed WBXML:'
    console.log obj

# With buffers (synchronous)
buf = fs.readFileSync 'example.wbxml'
obj = wbxml.decodeSync buf, language: 'ActiveSync'
console.log 'Parsed WBXML:'
console.log obj

JavaScript

fs = require('fs');
wbxml = require('lswbxml');

// With streams
file = fs.createReadStream('example.wbxml');
file.on('open', function() {
  wbxml.decode(file, {language: 'ActiveSync'}, function(err, obj) {
    if (err) {
      throw err;
    }
    console.log('Parsed WBXML:');
    console.log(obj);
  });
});

// With buffers (synchronous)
buf = fs.readFileSync('example.wbxml');
obj = wbxml.decodeSync(buf, {language: 'ActiveSync'});
console.log('Parsed WBXML:');
console.log(obj);

Parsing WBXML stream

LiveScript:

require! fs
wbxml = require \lswbxml

file = fs.create-read-stream 'example.wbxml'
<-! file.on \open
obj = null
decoder = new wbxml.Decoder language: \ActiveSync
  ..on \error !->
    throw it
  ..on \readable !->
    obj := decoder.read!
  ..on \end !->
    throw Error("Incomplete WBXML stream") if not obj?
    console.log 'Parsed WBXML:'
    console.log obj
file.pipe decoder

CoffeeScript:

fs = require 'fs'
wbxml = require 'lswbxml'

file = fs.createReadStream 'example.wbxml'
file.on 'open', ->
  obj = null
  decoder = new wbxml.Decoder language: 'ActiveSync'
  decoder.on 'error', (err)->
      throw err
  decoder.on 'readable', ->
      obj = decoder.read()
  decoder.on 'end', ->
      throw Error("Incomplete WBXML stream") if obj is null
      console.log 'Parsed WBXML:'
      console.log obj
  file.pipe decoder

JavaScript:

fs = require('fs');
wbxml = require('lswbxml');

file = fs.createReadStream('example.wbxml');
file.on('open', function() {
  var obj = null;
  decoder = new wbxml.Decoder({language: 'ActiveSync'});
  decoder.on('error', function(err) {
    throw err;
  });
  decoder.on('readable', function() {
    obj = decoder.read();
  });
  decoder.on('end', function() {
    if (obj === null) {
      throw Error('Incomplete WBXML stream');
    }
    console.log('Parsed WBXML:');
    console.log(obj);
  });
  file.pipe(decoder);
});

Building from source

Install gulp with:

npm install -g gulp

And run:

gulp build

or:

gulp watch

for continuous integration.

Testing

Run:

gulp test

Changelog

0.2.3 (2014-03-26)

Bug Fixes

• build:
  • improve gulpfile (6b7d1482)
  • don't halt on errors while watching (50fa0542)
  • remove old version bump script (0426b739)
• docs: update proxy to reflect build system changes (3f6f17f5)

Features

• build: add git support and conventional changelog (f7a2e659)
• tree: convert boolean values to '1's and '0's (0065a7f9)

<a name="0.2.2"></a>