JSONNeverDie aims to be a user friendly JSON encode / decoder for iOS written with pure Swift which never dies.
Features
- [x] supports all types: Int, Float, String, Array
- [x] user friendly: Xcode can prompt all available methods
- [x] provides both Optional-type(Int?) and Original-type(Int)
- [x] well tested
Requirements
- iOS 7.0+
- Xcode 7
Use
import
import JSONNeverDie
basic example
parse a JSON from network and get a string:
let data = NSData(contentsOfURL: NSURL(string: "http://httpbin.org/get?hello=world")!)!
let json = JSONND.initWithData(data)
print(json["args"]["hello"].stringValue)
generate a JSONND object
let data = NSData()
// init from NSData
let json = JSONND.initWithData(data)
// init from Array
let jsonArray: JSONND = ["hello", "world", 100]
// init from Dictionary
let jsonDictionary: JSONND = ["hello": "world", "hey": "guys"]
get values
let value = json["key"].int
let value = json["key"].intValue
let value = json["key"].string
let value = json["key"].stringValue
let value = json["key"].float
let value = json["key"].floatValue
let value = json["key"].array
let value = json["key"].arrayValue
// more than one level
let value = json["key"]["key1"]["key2"].int
deal with array
if let jsonArray = json["array"].array {
for jsonItem in jsonArray {
let value = jsonItem["key"].int
}
}
// or just
let value = json["array"].arrayValue[0]["key"].int
Xcode can prompt all available methods
get raw string from a JSONND object
let string = json.jsonString
Installation
Carthage
Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.
You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage
To integrate JSONNeverDie into your Xcode project using Carthage, specify it in your Cartfile:
github "JohnLui/JSONNeverDie"
Then fetch and build JSONNeverDie:
carthage update
At last, add it to "Embedded Binaries" in the general panel use the "Add Other..." button. The JSONNeverDie.framework binary file is lying in ./Carthage/Build/iOS directory.
Manually
git submodule add https://github.com/johnlui/JSONNeverDie.git
open JSONNeverDie
then drag JSONNeverDie.xcodeproj to your Project, that's it!
If you want to run your project on device with JSONNeverDie, just go to PROJECT->TARGETS->[your project name]->General->Embedded Binaries, click ＋, select JSONNeverDie.frameWork and click "Add".
Source File
Drag JSONNeverDie/JSONNeverDie.swift into your project.
Contribution
You are welcome to fork and submit pull requests.
License
JSONNeverDie is open-sourced software licensed under the MIT license.
