GitHub - mmattozzi/json-framework: JSON (JavaScript Object Notation) is a light-weight data interchange format that's easy to read and write for humans and computers alike. This framework implements a strict JSON parser and generator in Objective-C.

SBJson 4

Fork note

This is a fork of the excellent SBJson (aka json framework) that has two optimizations for pretty printing convenience. I made these changes to support my project CocoaRestClient where the goal for JSON parsing/printing is to read in an HTTP body and pretty print it.

Dictionary keys are stored in an OrderedDictionary (thank you, http://www.cocoawithlove.com/2008/12/ordereddictionary-subclassing-cocoa.html). Even though JSON is unordered, for the purposes of testing an API, order helps human brains.
Numbers are parsed into a wrapper class that stores both the original string and the conversion into an NSNumber. When the JSON is written back out, any number wrappers that are encountered use the original string as output. This prevents confusing precision errors when pretty printing is executed.

Back to your regularly scheduled readme...

JSON (JavaScript Object Notation) is a light-weight data interchange format that's easy to read and write for humans and computers alike. This library implements chunk-based JSON parsing and generation in Objective-C.

Features

SBJson's number one feature is chunk-based operation. Feed the parser one or more chunks of UTF8-encoded data and it will call a block you provide with each root-level document or array. Or, optionally, for each top-level entry in each root-level array. See more in the Version 4 API docs.

Other features:

Configurable recursion limit. For safety SBJson defaults to a max nesting level of 32 for all input. This can be configured if necessary.
The writer can optionally sort dictionary keys so output is consistent across writes.
The writer can optionally create human-readable (indented) output.

API Documentation

Please see the API Documentation for more details.

Installation

The preferred way to use SBJson is by using CocoaPods. In your Podfile use:

If you depend on a third-party library that requires an earlier version of SBJson---or want to install both version 3 and 4 in the same app to do a gradual transition---you can instead use:

pod 'SBJson4', '~> 4.0.1'

An alternative that I no longer recommend is to copy all the source files (the contents of the src/main/objc folder) into your own Xcode project.

Examples

https://github.com/stig/ChunkedDelivery - a toy example showing how one can use NSURLSessionDataDelegate to do chunked delivery.
https://github.com/stig/DisplayPretty - a very brief example using SBJson 4 to reflow JSON on OS X.

Support

Check StackOverflow questions tagged with SBJson if you have questions about how to use the library. I try to read all questions with this tag.
Use the issue tracker if you have found a bug.

License

BSD. See LICENSE for details.