🐍 Serpent (previously known as Serializable) is a framework made by us at Nodes for creating model objects or structs that can be easily serialized and deserialized from/to JSON.
It's designed to be used together with our helper app, the 
In this repo we compare Serpent with other popular JSON mapping frameworks.
So how fast is Serpent? Why should I use Serpent instead of one of the many other Encoding/Decoding frameworks out there? What features does Serpent lack?
Let's find out! (or, you can skip to the results)
Note: All of the following can be found in the Performance Tests in this repo.
We need something big to test. Parsing a small 10-line JSON object doesn't help illustrate performance. So let's see how it does with an object like this:
{
"id": "56cf043e934a463a49375405"
"index" : 0,
"guid": "8dfb0059-93fc-4369-83a8-60cbad659d5f",
"isActive": true,
"balance": "$3,976.78",
"picture": "http://placehold.it/32x32",
"age": 22,
"eyeColor": "green",
"name": {
"last": "Workman",
"first": "Rhonda"
},
"company": "PLASMOSIS",
"email": "[email protected]",
"phone": "+1 (823) 453-2185",
"address": "311 Scott Avenue, Maplewood, Kansas, 2955",
"about": "Commodo veniam pariatur ea ut duis incididunt. Eiusmod consequat quis ex consequat cillum exercitation enim voluptate eiusmod aliquip. Sunt dolor ea cillum nisi commodo aliqua velit dolor. Ad incididunt sint est consequat eiusmod laboris anim aute velit dolore ut ea sint Lorem. Tempor consectetur incididunt minim sunt ipsum velit ut et duis occaecat enim. Est exercitation eiusmod mollit incididunt occaecat occaecat do. Laboris ea enim eu dolor duis est occaecat est enim amet proident id.",
"registered": "Saturday, June 6, 2015 9:22 AM",
"latitude": "16.640946",
"longitude": "-122.190771",
"greeting": "Hello, Rhonda! You have 7 unread messages.",
"favoriteFruit": "strawberry"
}
A good mix of types, there are Int, String, Enum, NSURL, and nested objects. But again, this isn't enough for useful metrics. So lets use 10,000 of these. A 10.1 MB file should be good enough.
Let's also test 10,000 of a smaller object as well, to see how that impacts performance:
{
"id": "56cf0c0c4d93367b1d9282b3",
"name": "Catherine"
}
This file is only 6% of the bigger file's size.
So let's create our models now. We want to make the data as useful as possible, so we should use the appropriate data types when possible (not just using String for everything).
struct PerformanceTestModel {
enum EyeColor: String {
case Blue = "blue"
case Green = "green"
case Brown = "brown"
}
enum Fruit: String {
case Apple = "apple"
case Banana = "banana"
case Strawberry = "strawberry"
}
var id = ""
var index = 0
var guid = ""
var isActive = true
var balance = ""
var picture: NSURL?
var age = 0
var eyeColor: EyeColor = .Brown
var name = Name()
var company = ""
var email = ""
var phone = ""
var address = ""
var about = ""
var registered = ""
var latitude = 0.0
var longitude = 0.0
var greeting = ""
var favoriteFruit: Fruit?
}
struct Name {
var first = ""
var last = ""
}struct PerformanceTestSmallModel {
var id = ""
var name = ""
}Serpent doesn't care if you use implicit or explicit types, so it is only added when needed (for Enum, nested types, or optionals, for example). Also, we could of course use optionals for these fields instead of default values (favoriteFruit vs. eyeColor, for example).
So now we want to parse the JSON into this model. With Serpent, this is done by conforming to Decodable and implementing init(dictionary:NSDictionary?) (all done automatically in a split-second if you use our
extension PerformanceTestModel: Serializable {
init(dictionary: NSDictionary?) {
id <== (self, dictionary, "id")
index <== (self, dictionary, "index")
guid <== (self, dictionary, "guid")
isActive <== (self, dictionary, "isActive")
balance <== (self, dictionary, "balance")
picture <== (self, dictionary, "picture")
age <== (self, dictionary, "age")
eyeColor <== (self, dictionary, "eyeColor")
name <== (self, dictionary, "name")
company <== (self, dictionary, "company")
email <== (self, dictionary, "email")
phone <== (self, dictionary, "phone")
address <== (self, dictionary, "address")
about <== (self, dictionary, "about")
registered <== (self, dictionary, "registered")
latitude <== (self, dictionary, "latitude")
longitude <== (self, dictionary, "longitude")
greeting <== (self, dictionary, "greeting")
favoriteFruit <== (self, dictionary, "favoriteFruit")
}
}Now PerformanceTestModel is ready to decode some JSON. Since loading the raw JSON data isn't something Serpent (or any other similar framework) is concerned with, we don't need to test the performance of that, so we'll just load the data like this:
override func setUp() {
super.setUp()
if let path = Bundle(for: type(of: self)).path(forResource: "PerformanceTest", ofType: "json"), let data = NSData(contentsOfFile: path) {
largeData = data
}
if let path = Bundle(for: type(of: self)).path(forResource: "PerformanceSmallTest", ofType: "json"), let data = NSData(contentsOfFile: path) {
smallData = data
}
}Normally, we would also parse this JSON data into a dictionary using NSJSONSerialization, but some frameworks have their own JSON parsing logic, so we'll measure the performance of the parsing as well as decoding.
So let's test it!
func testSerpentBig() {
self.measure { () -> Void in
do {
self.jsonDict = try JSONSerialization.jsonObject(with: self.largeData as Data, options: .allowFragments) as? NSDictionary
let _ = PerformanceTestModel.array(self.jsonDict["data"])
}
catch {
print(error)
}
}
}
func testSerpentSmall() {
self.measure {
do {
self.smallJsonDict = try JSONSerialization.jsonObject(with: self.smallData as Data, options: .allowFragments) as? NSDictionary
let _ = PerformanceTestSmallModel.array(self.smallJsonDict["data"])
}
catch {
print(error)
}
}
}Note: All of these tests are run on an iPhone 6S after a clean build.
| Test | Result |
|---|---|
| Serpent Large Model | 0.692 sec |
| Serpent Small Model | 0.084 sec |
Not too bad for 10,000 objects.
But how does it compare to other frameworks? We looked at 6 other popular frameworks to compare our results: Freddy, Gloss, ObjectMapper, JSONCodable, Unbox, Decodable.
Before we can compare results, we have a few issues to resolve. Freddy only supports primitive types and collections, so no Enum, NSURL, or odd cases (such as the latitude and longitude fields, which are String in the JSON but Double in our model). Others can't handle the NSURL. So to be fair, we'll remove those properties from the test.
Later edit: We also got PRs that added the following frameworks: Marshal (thanks to bre7).
Note: If you're curious about the usage of the other frameworks, you can have a look at the test file.
| Test | Large Model | Small Model |
|---|---|---|
| Serpent | 0.711 sec | 0.085 sec |
| Freddy | 0.670 sec | 0.097 sec |
| Gloss | 2.682 sec | 0.360 sec |
| ObjectMapper | 2.279 sec | 0.348 sec |
| JSONCodable | 4.363 sec | 0.510 sec |
| Unbox | 3.102 sec | 0.372 sec |
| Decodable | 1.642 sec | 0.215 sec |
| Marshal | 0.528 sec | 0.096 sec |
The tests were last run locally on device on 8 March 2017. Here's the full output
We're running those performance tests on CI too, so you can see the latest results on Travis-CI. The times on Travis are different, but the general picture is the same.
Here's a chart with the results from the tests ran on an iPhone 6S after a clean build on 8 March 2017. Lower is better.
When it comes to mapping, Marshal is the fastest, followed by Freddy and Serpent (the order between Freddy and Serpent varies from one test to another and we'd say is pretty negligible). Overall, all three frameworks performed way better than the others.
So you've seen the performance tests, but what about features?
| Serpent | Freddy | Gloss | ObjectMapper | JSONCodable | Unbox | Decodable | Marshal | |
|---|---|---|---|---|---|---|---|---|
| Parses primitive types | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Parses nested objects | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Parses Enum types | ✔️ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ❌ | ✔️ |
| Parses other types (e.g. NSURL, UIColor) | ✔️ | ❌ | ✔️ | ❌ | ❌ | ✔️ | ❌ | partially1 |
| Easy protocol conformance syntax with custom operator | ✔️ | ❌ | ✔️ | ✔️ | ❌ | ❌ | ✔️ | ✔️ |
| Flexible mapping function without complicated generics syntax or casting | ✔️ | ✔️ | ❌ | ❌ | ❌ | ✔️ | ✔️ | ✔️ |
| Decodes without needing to handle errors | ✔️ | ❌ | ✔️ | ✔️ | ❌ | ✔️ | ✔️ | ✔️ |
| Auto-generated code from Model Boiler | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Great Performance | ✔️ | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔️ |
1 Marshal supports NSURL, doesn't support UIColor, but you can manually create extensions that will parse it.
Serpent meets the best balance between speed and its number of features. But don't take our word for it, try it out and see for yourself! And don't forget, we have the
We know there are other JSON mapping frameworks out there. We would like to add more of them to this comparison, so its results are even more reflective of the current JSON mapping framework environment. However, we don't have a specific timeline for adding more libraries. We gladly accept Pull Requests to this repo that add other frameworks for the comparison.
In order to be merged, a PR that adds a new JSON mapping framework:
- must add the new framework via Carthage
- must not break any of the other framework's usage implementation
- must add performance tests that use the same data as the others (it's ok to add new json data for testing as long as you run the same tests for all the frameworks)
- must edit the correctness test to check that the parsing is correct for the new mapping framework added
- must not break the CI build
We want those tests to be as fair as possible and to have the same conditions for all the frameworks that we test.
We reserve the right to close issues that only say "Please add <insert_mapping_framework_name_here> to your tests", without a PR that adds that library. We don't want the issues of this repo to turn into a list of all the JSON mapping frameworks available. But we're very happy for pull requests 🤓
- Clone the repo
- Run
carthage bootstrap --platform ios(If you don't have Carthage installed, you can install it like this) - Open the project in Xcode
- Run the tests (Product -> Test, or ⌘-U)
- See the results in the debug console
Serpent,
Serpent Performance Comparison is available under the MIT license. See the LICENSE file for more info.