← Back to branch summary

~noskcaj/ubuntu/trusty/argyll/merge

« back to all changes in this revision

Viewing changes to jcnf/yajl/README

  • Committer: Bazaar Package Importer
  • Author(s): Roland Mas
  • Date: 2009-12-10 17:26:04 UTC
  • mfrom: (1.1.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20091210172604-pfjrmh0cag9hn0x8
Tags: 1.1.0~rc2-1
* New upstream pre-release.
* Updated location of Bazaar branches in control file.
* The Debian-specific branch now feeds from the "midstream" branch
  rather than the "upstream-releases" branch, to ease collaboration with
  other distributions.  This shouldn't make any difference on the
  package contents.

Show diffs side-by-side

added added

removed removed

Lines of Context:
jcnf/yajl/README
4
4
 
5
5
Good question.  In a review of current C JSON parsing libraries I was 
6
6
unable to find one that satisfies my requirements.  Those are, 
7
 
0. Written in C
 
7
0. written in C
8
8
1. portable
9
 
2. robust, as close to "crash proof" as possible
 
9
2. robust -- as close to "crash proof" as possible
10
10
3. data representation independent
11
11
4. fast
12
 
5. generates verbose, useful error messages including.
 
12
5. generates verbose, useful error messages including context of where
 
13
   the error occurs in the input text.
13
14
6. can parse JSON data off a stream, incrementally
14
15
7. simple to use
15
16
8. tiny
22
23
 
23
24
BSD licensing means you can use it in open source and commercial products
24
25
alike.  My request beyond the licensing is that if you find bugs drop
25
 
me a email.  I'm eager to hear feedback about the design.
 
26
me a email, or better yet, fork me on git and fix it!
26
27
 
27
28
Porting YAJL should be trivial, the implementation is ANSI C.  If you
28
 
port to new systems I'd love to hear of it, and I'd love to integrate
29
 
your patches.
 
29
port to new systems I'd love to hear of it and integrate your patches.
30
30
 
31
31
## YAJL is data representation independent.
32
32
 
33
33
BYODR!  Many JSON libraries impose a structure based data representation
34
34
on you.  This is a benefit in some cases and a drawback in others.
35
 
YAJL uses call-backs to remain agnostic of the in memory representation.
36
 
So if you wish to build up an in memory representation, you may do so
 
35
YAJL uses callbacks to remain agnostic of the in-memory representation.
 
36
So if you wish to build up an in-memory representation, you may do so
37
37
using YAJL, but you must bring the code that defines and populates the
38
38
in memory structure.
39
39
 
65
65
Fat free.  No whip.
66
66
 
67
67
enjoy,
68
 
Lloyd - July, 2007
 
68
Lloyd - July, 2007