JSONHelper 
Convert anything into anything in one operation; hex strings into UIColor/NSColor, JSON strings into class instances, y/n strings to booleans, arrays and dictionaries of these; anything you can make sense of!
Latest version requires iOS 8+ and Xcode 7.3+
Table of Contents
- Installation
- The <-- Operator
- Convertible Protocol
- Deserializable Protocol (with JSON deserialization example)
- Serializable Protocol
Installation
CocoaPods
Add the following line in your Podfile.
pod "JSONHelper"
Carthage
Add the following line to your Cartfile.
github "isair/JSONHelper"
Then do carthage update. After that, add the framework to your project.
The <-- Operator
The <-- operator takes the value on its right hand side and tries to convert it into the type of the value on its left hand side. If the conversion fails, an error is logged on debug builds. If it's successful, the value of the left hand side variable is overwritten. It's chainable as well.
If the right hand side value is nil or the conversion fails, and the left hand side variable is an optional, then nil is assigned to it. When the left hand side is non-optional, the current value of the left hand side variable is left untouched.
Using this specification let's assume you have a dictionary response that you retrieved from some API with hex color strings in it, under the key colors, that you want to convert into an array of UIColor instances. Also, to fully use everything we know, let's also assume that we want to have a default value for our color array in case the value for the key we're looking for does not exist (is nil).
var colors = [UIColor.blackColor(), UIColor.whiteColor()]
// Assume we have response { "colors": ["#aaa", "#b06200aa"] }
colors <-- response[colorsKey]
Convertible Protocol
If your type is a simple value-like type, adopting the Convertible protocol is the way to make your type work with the <-- operator.
Example:
struct Vector2D: Convertible {
var x: Double = 0
var y: Double = 0
init(x: Double, y: Double) {
self.x = x
self.y = y
}
static func convertFromValue<T>(value: T?) throws -> Self? {
guard let value = value else { return nil }
if let doubleTupleValue = value as? (Double, Double) {
return self.init(x: doubleTupleValue.0, y: doubleTupleValue.1)
}
throw ConversionError.UnsupportedType
}
}
var myVector: Vector2D?
myVector <-- (1.0, 2.7)
Deserializable Protocol
While you can basically adopt the Convertible protocol for any type, if your type is always converted from a dictionary or a JSON string then things can get a lot easier with the Deserializable protocol.
Example:
class User: Deserializable {
static let idKey = "id"
static let emailKey = "email"
static let nameKey = "name"
static let avatarURLKey = "avatar_url"
private(set) var id: String?
private(set) var email: String?
private(set) var name = "Guest"
private(set) var avatarURL = NSURL(string: "https://mysite.com/assets/default-avatar.png")
required init(dictionary: [String : AnyObject]) {
id <-- dictionary[User.idKey]
email <-- dictionary[User.emailKey]
name <-- dictionary[User.nameKey]
avatarURL <-- dictionary[User.avatarURLKey]
}
}
var myUser: User?
user <-- apiResponse["user"]
Serializable Protocol
// Serialization is coming soon. I'll probably not add a new protocol and just rename and update the Deserializable protocol and turn it into a mixin.
8.5k Jan 3, 2023
6.9k Dec 8, 2022
9k Jan 2, 2023
1 Nov 4, 2021
350 Oct 15, 2022
749 Dec 5, 2022
31 Nov 22, 2021
454 Oct 30, 2022
8 Nov 22, 2022
0 Oct 29, 2021
43 Dec 15, 2022
611 Oct 23, 2022
4.1k Dec 29, 2022
3 Apr 2, 2022
1 Nov 18, 2021
533 Nov 3, 2022