Skip to content
This repository

benejson JSON parsing library

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 benejson
Octocat-spinner-32 data
Octocat-spinner-32 javascript
Octocat-spinner-32 tests
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README
Octocat-spinner-32 SConstruct
README
benejson Library
----------------

SUMMARY

Abstract:
	benejson is a buffering SAX-style JSON parsing library. The library package contains 3 major components:
	-benejson.js: A pure javascript SAX-style parser
	-PullParser: A C++ class for JSON pull parsing
	-benejson.c: The parsing core written in C

Please see http://codehero.github.com/benejson/ for more background information.


Current release information:
	Date: February 21, 2011
	Version: 0.9.5
	Type: C++ and C are in Beta, benejson.js is in early alpha


Current version dependencies:
  -Usable <stdint.h>
	-Optional <wchar.h>, <math.h>
	-C++ for pull parsing
	-scons building environment (http://www.scons.org)
	-POSIX compliant environment to build test cases
	-No external dependencies for benejson.js


BUILDING 
  -Run scons to compile. This will build the library and tests.

RUNNING TESTS
	-This source package does not attempt to install to your system. Please check
	 the web pages for system installation packages.
  -As a development package, this doesn't really establish linking rules.
	 If you get linker errors, point LD_LIBRARY_PATH to the lib directory.
	-cdb-view.js is meant to take as stdin input a couchdb view response.
	-Run

	 node nodetest.js < config.json

	 as demonstration of the library.

NOTES

Version 0.9.5 Known Bugs/TODO:

1) benejson currently does not translate escape characters in map keys to UTF-8.
As an example, benejson would interpret {"key\n":0} as a key with 4 characters; it would NOT convert '\n' to a single char.
Obviously this is broken behaviour according the JSON spec, but I will only fix it if somebody really needs it...
2) Similarly, benejson only optimizes its key search for strings in UTF-8.
UTF-16/32 strings should be converted to UTF-8 and lexicographically sorted to use this functionality.
3) jsonoise generates a limited subset of strings (only UTF-8, no escapes)
4) jsonoise should also generate JSON with a single error
5) benejson.js is in alpha and at the moment does not strictly check syntax

Copyright (c) 2010 David Bender assigned to Benegon Enterprises LLC
See the file LICENSE for full license information.
Something went wrong with that request. Please try again.