version: 1.3.6

chore: carthage update --platform macos
version: 1.3.5
2019-05-29 14:29:58 +10:00 · 2019-05-29 14:29:39 +10:00 · 2019-05-29 14:25:36 +10:00 · 2019-05-29 14:23:53 +10:00 · 2019-05-28 15:47:46 +02:00 · 2019-03-04 10:42:15 +11:00
166 changed files with 6555 additions and 1052 deletions
@@ -1,4 +1,4 @@
-github "SwiftyJSON/SwiftyJSON" "4.1.0"
+github "SwiftyJSON/SwiftyJSON" "5.0.0"
 github "acheronfail/MASShortcut" "2.3.6-custom"
 github "emaloney/CleanroomLogger" "6.0.2"
-github "sindresorhus/LaunchAtLogin" "v2.1.0"
+github "sindresorhus/LaunchAtLogin" "v2.5.0"
@@ -1,2 +1 @@
-* text=auto
-*.swift text eol=lf
+* text=auto eol=lf
@@ -0,0 +1,14 @@
+Pod::Spec.new do |s|
+	s.name = 'LaunchAtLogin'
+	s.version = '2.5.0'
+	s.summary = 'Add "Launch at Login" functionality to your sandboxed macOS app in seconds'
+	s.license = 'MIT'
+	s.homepage = 'https://github.com/sindresorhus/LaunchAtLogin'
+	s.social_media_url = 'https://twitter.com/sindresorhus'
+	s.authors = { 'Sindre Sorhus' => 'sindresorhus@gmail.com' }
+	s.source = { :git => 'https://github.com/sindresorhus/LaunchAtLogin.git', :tag => "v#{s.version}" }
+	s.source_files = 'LaunchAtLogin', 'LaunchAtLoginHelper'
+	s.resource = 'LaunchAtLogin/copy-helper.sh'
+	s.swift_version = '4.2'
+	s.platform = :macos, '10.12'
+end
@@ -3,7 +3,7 @@
 	archiveVersion = 1;
 	classes = {
 	};
-	objectVersion = 50;
+	objectVersion = 51;
 	objects = {

 /* Begin PBXBuildFile section */
@@ -32,8 +32,8 @@
 		E32E9B741EB87EA3000FEEE9 /* LaunchAtLoginHelper.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = LaunchAtLoginHelper.app; sourceTree = BUILT_PRODUCTS_DIR; };
 		E32E9B761EB87EA3000FEEE9 /* main.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; lineEnding = 0; path = main.swift; sourceTree = "<group>"; usesTabs = 1; };
 		E32E9B7F1EB87EA3000FEEE9 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
-		E32E9B831EB87F57000FEEE9 /* LaunchAtLoginHelper.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = LaunchAtLoginHelper.entitlements; sourceTree = "<group>"; };
 		E32E9B921EB889AE000FEEE9 /* copy-helper.sh */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.script.sh; lineEnding = 0; path = "copy-helper.sh"; sourceTree = "<group>"; usesTabs = 1; };
+		E3B8C38A20C0003300272EC0 /* LaunchAtLoginHelper.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = LaunchAtLoginHelper.entitlements; sourceTree = "<group>"; };
 /* End PBXFileReference section */

 /* Begin PBXFrameworksBuildPhase section */
@@ -89,7 +89,7 @@
 			children = (
 				E32E9B761EB87EA3000FEEE9 /* main.swift */,
 				E32E9B7F1EB87EA3000FEEE9 /* Info.plist */,
-				E32E9B831EB87F57000FEEE9 /* LaunchAtLoginHelper.entitlements */,
+				E3B8C38A20C0003300272EC0 /* LaunchAtLoginHelper.entitlements */,
 			);
 			path = LaunchAtLoginHelper;
 			sourceTree = "<group>";
@@ -151,17 +151,20 @@
 			isa = PBXProject;
 			attributes = {
 				LastSwiftUpdateCheck = 0830;
-				LastUpgradeCheck = 0930;
+				LastUpgradeCheck = 0940;
 				ORGANIZATIONNAME = "Sindre Sorhus";
 				TargetAttributes = {
 					E32E9B621EB87D7B000FEEE9 = {
 						CreatedOnToolsVersion = 8.3.2;
-						LastSwiftMigration = 0900;
+						LastSwiftMigration = "";
 					};
 					E32E9B731EB87EA3000FEEE9 = {
 						CreatedOnToolsVersion = 8.3.2;
-						LastSwiftMigration = 0900;
+						LastSwiftMigration = "";
 						SystemCapabilities = {
+							com.apple.HardenedRuntime = {
+								enabled = 1;
+							};
 							com.apple.Sandbox = {
 								enabled = 1;
 							};
@@ -170,7 +173,7 @@
 				};
 			};
 			buildConfigurationList = E32E9B5D1EB87D7B000FEEE9 /* Build configuration list for PBXProject "LaunchAtLogin" */;
-			compatibilityVersion = "Xcode 9.3";
+			compatibilityVersion = "Xcode 10.0";
 			developmentRegion = English;
 			hasScannedForEncodings = 0;
 			knownRegions = (
@@ -265,7 +268,7 @@
 				CLANG_WARN_SUSPICIOUS_MOVE = YES;
 				CLANG_WARN_UNREACHABLE_CODE = YES;
 				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
-				CODE_SIGN_IDENTITY = "-";
+				CODE_SIGN_IDENTITY = "";
 				COPY_PHASE_STRIP = NO;
 				CURRENT_PROJECT_VERSION = 1;
 				DEBUG_INFORMATION_FORMAT = dwarf;
@@ -328,7 +331,7 @@
 				CLANG_WARN_SUSPICIOUS_MOVE = YES;
 				CLANG_WARN_UNREACHABLE_CODE = YES;
 				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
-				CODE_SIGN_IDENTITY = "-";
+				CODE_SIGN_IDENTITY = "";
 				COPY_PHASE_STRIP = NO;
 				CURRENT_PROJECT_VERSION = 1;
 				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
@@ -357,7 +360,7 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				CLANG_ENABLE_MODULES = YES;
-				CODE_SIGN_IDENTITY = "Mac Developer";
+				CODE_SIGN_IDENTITY = "";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
 				DEFINES_MODULE = YES;
@@ -379,8 +382,7 @@
 				SKIP_INSTALL = YES;
 				SWIFT_COMPILATION_MODE = singlefile;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
-				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 4.2;
 			};
 			name = Debug;
 		};
@@ -388,7 +390,7 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				CLANG_ENABLE_MODULES = YES;
-				CODE_SIGN_IDENTITY = "Mac Developer";
+				CODE_SIGN_IDENTITY = "";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
 				DEFINES_MODULE = YES;
@@ -408,8 +410,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
 				SKIP_INSTALL = YES;
-				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 4.2;
 			};
 			name = Release;
 		};
@@ -421,6 +422,7 @@
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
 				DEVELOPMENT_TEAM = YG56YK5RN5;
+				ENABLE_HARDENED_RUNTIME = YES;
 				INFOPLIST_FILE = LaunchAtLoginHelper/Info.plist;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
@@ -430,8 +432,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
 				SKIP_INSTALL = YES;
-				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 4.2;
 			};
 			name = Debug;
 		};
@@ -443,6 +444,7 @@
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
 				DEVELOPMENT_TEAM = YG56YK5RN5;
+				ENABLE_HARDENED_RUNTIME = YES;
 				INFOPLIST_FILE = LaunchAtLoginHelper/Info.plist;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
@@ -452,8 +454,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
 				SKIP_INSTALL = YES;
-				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 4.2;
 			};
 			name = Release;
 		};
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0930"
+   LastUpgradeVersion = "0940"
   version = "1.3">
   <BuildAction
      parallelizeBuildables = "YES"
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0930"
+   LastUpgradeVersion = "0940"
   version = "1.3">
   <BuildAction
      parallelizeBuildables = "YES"
@@ -2,8 +2,6 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-	<key>CFBundleDevelopmentRegion</key>
-	<string>en</string>
 	<key>CFBundleExecutable</key>
 	<string>$(EXECUTABLE_NAME)</string>
 	<key>CFBundleIdentifier</key>
@@ -15,12 +13,10 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>2.1.0</string>
+	<string>2.5.0</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 	<key>NSHumanReadableCopyright</key>
 	<string>MIT © Sindre Sorhus</string>
-	<key>NSPrincipalClass</key>
-	<string></string>
 </dict>
 </plist>
@@ -9,9 +9,14 @@ mkdir -p "$helper_dir"
 cp -rf "$origin_helper_path" "$helper_dir/"

 defaults write "$helper_path/Contents/Info" CFBundleIdentifier -string "$PRODUCT_BUNDLE_IDENTIFIER-LaunchAtLoginHelper"
-codesign --force --entitlements="$CODE_SIGN_ENTITLEMENTS" --sign="$EXPANDED_CODE_SIGN_IDENTITY_NAME" "$helper_path"
+
+if [[ -n $CODE_SIGN_ENTITLEMENTS ]]; then
+	codesign --force --entitlements="$CODE_SIGN_ENTITLEMENTS" --options=runtime --sign="$EXPANDED_CODE_SIGN_IDENTITY_NAME" "$helper_path"
+else
+	codesign --force --options=runtime --sign="$EXPANDED_CODE_SIGN_IDENTITY_NAME" "$helper_path"
+fi

 if [[ $CONFIGURATION == "Release" ]]; then
 	rm -rf "$origin_helper_path"
-	rm "$(dirname $origin_helper_path)/copy-helper.sh"
+	rm "$(dirname "$origin_helper_path")/copy-helper.sh"
 fi
@@ -2,8 +2,6 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-	<key>CFBundleDevelopmentRegion</key>
-	<string>en</string>
 	<key>CFBundleExecutable</key>
 	<string>$(EXECUTABLE_NAME)</string>
 	<key>CFBundleIdentifier</key>
@@ -0,0 +1,21 @@
+# Before and after
+
+With `LaunchAtLogin`, you only have to do 2 steps instead of 13!
+
+```diff
+-  1. Create a new target that will be the helper app that launches your app
+-  2. Set `LSBackgroundOnly` to true in the `Info.plist` file
+-  3. Set `Skip Install` to `YES` in the build settings for the helper app
+-  4. Enable sandboxing for the helper app
+-  5. Add a new `Copy Files` build phase to the main app
+-  6. Select `Wrapper` as destination
+-  7. Enter `Contents/Library/LoginItems` as subpath
+-  8. Add the helper build product to the build phase
+-  9. Copy-paste some boilerplate code into the helper app
+- 10. Remember to replace `bundleid.of.main.app` and `MainExectuableName` with your own values
+- 11. Copy-paste some code to register the helper app into your main app
+- 12. Make sure the main app and helper app use the same code signing certificate
+- 13. Manually verify that you did everything correctly
+  1. Install this package
+  2. Add a new "Run Script Phase"
+```
@@ -1,45 +1,35 @@
 # LaunchAtLogin

-> Add "Launch at Login" functionality to your sandboxed macOS app in seconds
+> Add "Launch at Login" functionality to your macOS app in seconds

-It's usually quite a convoluted and error-prone process to add this. **No more!**
+It's usually quite a [convoluted and error-prone process](before-after.md) to add this. **No more!**

-```diff
-  1. Create a new target that will be the helper app that launches your app
-  2. Set `LSBackgroundOnly` to true in the `Info.plist` file
-  3. Set `Skip Install` to `YES` in the build settings for the helper app
-  4. Enable sandboxing for the helper app
-  5. Add a new `Copy Files` build phase to the main app
-  6. Select `Wrapper` as destination
-  7. Enter `Contents/Library/LoginItems` as subpath
-  8. Add the helper build product to the build phase
-  9. Copy-paste some boilerplate code into the helper app
- 10. Remember to replace `bundleid.of.main.app` and `MainExectuableName` with your own values
- 11. Copy-paste some code to register the helper app into your main app
- 12. Make sure the main app and helper app use the same code signing certificate
- 13. Manually verify that you did everything correctly
-+  1. Install this package
-+  2. Add a new "Run Script Phase"
-```
+This package works with both sandboxed and non-sandboxed apps and it's App Store compatible and used in my [Lungo](https://blog.sindresorhus.com/lungo-b364a6c2745f) and [Battery Indicator](https://sindresorhus.com/battery-indicator) apps.

-It's App Store compatible and used in my [Lungo](https://blog.sindresorhus.com/lungo-b364a6c2745f) and [Battery Indicator](https://sindresorhus.com/battery-indicator) app.
-
-You might also find my [`create-dmg`](https://github.com/sindresorhus/create-dmg) project useful.
+*You might also find my [`create-dmg`](https://github.com/sindresorhus/create-dmg) project useful if you're publishing your app outside the App Store.*


 ## Requirements

 - macOS 10.12+
- Xcode 9.3+
- Swift 4.1+
+- Xcode 10+
+- Swift 4.2+


-## Install with [Carthage](https://github.com/Carthage/Carthage#getting-started)
+## Install
+
+#### Carthage

 ```
 github "sindresorhus/LaunchAtLogin"
 ```

+#### CocoaPods
+
+```ruby
+pod 'LaunchAtLogin'
+```
+
 <a href="https://www.patreon.com/sindresorhus">
 	<img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" width="160">
 </a>
@@ -49,8 +39,16 @@ github "sindresorhus/LaunchAtLogin"

 Add a new ["Run Script Phase"](http://stackoverflow.com/a/39633955/64949) below "Embed Frameworks" in "Build Phases" with the following:

+Carthage:
+
 ```sh
-./Carthage/Build/Mac/LaunchAtLogin.framework/Resources/copy-helper.sh
+"${PROJECT_DIR}/Carthage/Build/Mac/LaunchAtLogin.framework/Resources/copy-helper.sh"
+```
+
+CocoaPods:
+
+```sh
+"${PROJECT_DIR}/Pods/LaunchAtLogin/LaunchAtLogin/copy-helper.sh"
 ```

 Use it in your app:
@@ -77,7 +75,10 @@ The framework bundles the helper app needed to launch your app and copies it int

 ## Related

+- [Defaults](https://github.com/sindresorhus/Defaults) - Swifty and modern UserDefaults
+- [Preferences](https://github.com/sindresorhus/Preferences) - Add a preferences window to your macOS app in minutes
 - [DockProgress](https://github.com/sindresorhus/DockProgress) - Show progress in your app's Dock icon
+- [More…](https://github.com/search?q=user%3Asindresorhus+language%3Aswift)


 ## License
@@ -1 +0,0 @@
-3.0
@@ -1,6 +1,6 @@
 language: objective-c
-osx_image: xcode9.3
-xcode_sdk: iphonesimulator10.0
+osx_image: xcode10.2
+xcode_sdk: iphonesimulator12.0
 script:
 - set -o pipefail
 - travis_retry xcodebuild -workspace SwiftyJSON.xcworkspace -scheme "SwiftyJSON iOS" -destination "platform=iOS Simulator,name=iPhone 6" build-for-testing test | xcpretty
@@ -32,7 +32,7 @@
 /* End PBXCopyFilesBuildPhase section */

 /* Begin PBXFileReference section */
-		04294C501BE5A9DE00D0397E /* Playground.playground */ = {isa = PBXFileReference; lastKnownFileType = file.playground; path = Playground.playground; sourceTree = "<group>"; };
+		04294C501BE5A9DE00D0397E /* Playground.playground */ = {isa = PBXFileReference; lastKnownFileType = file.playground; path = Playground.playground; sourceTree = "<group>"; xcLanguageSpecificationIdentifier = xcode.lang.swift; };
 		04733F511D92E6ED002E3A99 /* SwiftyJSON.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; path = SwiftyJSON.framework; sourceTree = BUILT_PRODUCTS_DIR; };
 		A82A1C1919D926B8009A653D /* Example.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Example.app; sourceTree = BUILT_PRODUCTS_DIR; };
 		A82A1C1D19D926B8009A653D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
@@ -124,19 +124,19 @@
 			isa = PBXProject;
 			attributes = {
 				LastSwiftUpdateCheck = 0700;
-				LastUpgradeCheck = 0930;
+				LastUpgradeCheck = 1020;
 				ORGANIZATIONNAME = swiftyjson;
 				TargetAttributes = {
 					A82A1C1819D926B8009A653D = {
 						CreatedOnToolsVersion = 6.0.1;
-						LastSwiftMigration = 0820;
+						LastSwiftMigration = 1020;
 						ProvisioningStyle = Manual;
 					};
 				};
 			};
 			buildConfigurationList = A82A1C1419D926B8009A653D /* Build configuration list for PBXProject "Example" */;
 			compatibilityVersion = "Xcode 3.2";
-			developmentRegion = English;
+			developmentRegion = en;
 			hasScannedForEncodings = 0;
 			knownRegions = (
 				en,
@@ -313,7 +313,7 @@
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				PRODUCT_BUNDLE_IDENTIFIER = "com.swiftyjson.$(PRODUCT_NAME:rfc1034identifier)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
-				SWIFT_VERSION = 3.0;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Debug;
 		};
@@ -328,7 +328,7 @@
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				PRODUCT_BUNDLE_IDENTIFIER = "com.swiftyjson.$(PRODUCT_NAME:rfc1034identifier)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
-				SWIFT_VERSION = 3.0;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Release;
 		};
@@ -28,7 +28,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

-    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        let navigationController = self.window?.rootViewController as! UINavigationController
        let viewController = navigationController.topViewController as! ViewController
@@ -29,7 +29,6 @@ let jsonString = String(data: jsonData!, encoding: .utf8)
 ### Initialization

 */
-import SwiftyJSON

 let json1 = try? JSON(data: jsonData!)
 /*:
@@ -1,4 +1,17 @@
+// swift-tools-version:5.0
 import PackageDescription

 let package = Package(
-    name: "SwiftyJSON")
+    name: "SwiftyJSON",
+    platforms: [
+        .macOS(.v10_10), .iOS(.v8), .tvOS(.v9), .watchOS(.v3)
+    ],
+    products: [
+        .library(name: "SwiftyJSON", targets: ["SwiftyJSON"])
+    ],
+    targets: [
+        .target(name: "SwiftyJSON", dependencies: []),
+        .testTarget(name: "SwiftJSONTests", dependencies: ["SwiftyJSON"])
+    ],
+    swiftLanguageVersions: [.v5]
+)
@@ -1,9 +1,15 @@
 # SwiftyJSON

-[![Travis CI](https://travis-ci.org/SwiftyJSON/SwiftyJSON.svg?branch=master)](https://travis-ci.org/SwiftyJSON/SwiftyJSON) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) ![CocoaPods](https://img.shields.io/cocoapods/v/SwiftyJSON.svg) ![Platform](https://img.shields.io/badge/platforms-iOS%208.0+%20%7C%20macOS%2010.10+%20%7C%20tvOS%209.0+%20%7C%20watchOS%202.0+-333333.svg)
+[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) ![CocoaPods](https://img.shields.io/cocoapods/v/SwiftyJSON.svg) ![Platform](https://img.shields.io/badge/platforms-iOS%208.0%20%7C%20macOS%2010.10%20%7C%20tvOS%209.0%20%7C%20watchOS%203.0-F28D00.svg) [![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)

 SwiftyJSON makes it easy to deal with JSON data in Swift.

+Platform | Build Status
+---------| --------------| 
+*OS      | [![Travis CI](https://travis-ci.org/SwiftyJSON/SwiftyJSON.svg?branch=master)](https://travis-ci.org/SwiftyJSON/SwiftyJSON)    | 
+[Linux](https://github.com/IBM-Swift/SwiftyJSON)      | [![Build Status](https://travis-ci.org/IBM-Swift/SwiftyJSON.svg?branch=master)](https://travis-ci.org/IBM-Swift/SwiftyJSON)     | 
+
+
 1. [Why is the typical JSON handling in Swift NOT good](#why-is-the-typical-json-handling-in-swift-not-good)
 2. [Requirements](#requirements)
 3. [Integration](#integration)
@@ -20,6 +26,7 @@ SwiftyJSON makes it easy to deal with JSON data in Swift.
   - [Merging](#merging)
 5. [Work with Alamofire](#work-with-alamofire)
 6. [Work with Moya](#work-with-moya)
+7. [SwiftyJSON Model Generator](#swiftyjson-model-generator)

 > [中文介绍](http://tangplin.github.io/swiftyjson/)

@@ -66,11 +73,12 @@ And don't worry about the Optional Wrapping thing. It's done for you automatical

 ```swift
 let json = JSON(data: dataFromNetworking)
-if let userName = json[999999]["wrong_key"]["wrong_name"].string {
+let result = json[999999]["wrong_key"]["wrong_name"]
+if let userName = result.string {
    //Calm down, take it easy, the ".string" property still produces the correct Optional String type with safety
 } else {
    //Print the error
-    print(json[999999]["wrong_key"]["wrong_name"])
+    print(result.error)
 }
 ```

@@ -161,7 +169,7 @@ let name = json[0].double

 ```swift
 // Getting an array of string from a JSON Array
-let arrayNames =  json["users"].arrayValue.map({$0["name"].stringValue})
+let arrayNames =  json["users"].arrayValue.map {$0["name"].stringValue}
 ```

 ```swift
@@ -547,3 +555,8 @@ provider.request(.showProducts) { result in
 }

 ```
+
+## SwiftyJSON Model Generator
+Tools to generate SwiftyJSON Models
+* [JSON Cafe](http://www.jsoncafe.com/)
+* [JSON Export](https://github.com/Ahmed-Ali/JSONExport)
@@ -24,22 +24,6 @@ import Foundation

 // MARK: - Error
 // swiftlint:disable line_length
-/// Error domain
-@available(*, deprecated, message: "ErrorDomain is deprecated. Use `SwiftyJSONError.errorDomain` instead.", renamed: "SwiftyJSONError.errorDomain")
-public let ErrorDomain: String = "SwiftyJSONErrorDomain"
-
-/// Error code
-@available(*, deprecated, message: "ErrorUnsupportedType is deprecated. Use `SwiftyJSONError.unsupportedType` instead.", renamed: "SwiftyJSONError.unsupportedType")
-public let ErrorUnsupportedType: Int = 999
-@available(*, deprecated, message: "ErrorIndexOutOfBounds is deprecated. Use `SwiftyJSONError.indexOutOfBounds` instead.", renamed: "SwiftyJSONError.indexOutOfBounds")
-public let ErrorIndexOutOfBounds: Int = 900
-@available(*, deprecated, message: "ErrorWrongType is deprecated. Use `SwiftyJSONError.wrongType` instead.", renamed: "SwiftyJSONError.wrongType")
-public let ErrorWrongType: Int = 901
-@available(*, deprecated, message: "ErrorNotExist is deprecated. Use `SwiftyJSONError.notExist` instead.", renamed: "SwiftyJSONError.notExist")
-public let ErrorNotExist: Int = 500
-@available(*, deprecated, message: "ErrorInvalidJSON is deprecated. Use `SwiftyJSONError.invalidJSON` instead.", renamed: "SwiftyJSONError.invalidJSON")
-public let ErrorInvalidJSON: Int = 490
-
 public enum SwiftyJSONError: Int, Swift.Error {
    case unsupportedType = 999
    case indexOutOfBounds = 900
@@ -146,19 +130,6 @@ public struct JSON {
 		}
 	}

-	/**
-	 Creates a JSON from JSON string
-	
-	 - parameter json: Normal json string like '{"a":"b"}'
-	
-	 - returns: The created JSON
-	 */
-    @available(*, deprecated, message: "Use instead `init(parseJSON: )`")
-    public static func parse(_ json: String) -> JSON {
-        return json.data(using: String.Encoding.utf8)
-            .flatMap { try? JSON(data: $0) } ?? JSON(NSNull())
-    }
-
 	/**
 	 Creates a JSON using the object.
 	
@@ -592,14 +563,6 @@ extension JSON: Swift.ExpressibleByArrayLiteral {
    }
 }

-extension JSON: Swift.ExpressibleByNilLiteral {
-
-    @available(*, deprecated, message: "use JSON.null instead. Will be removed in future versions")
-    public init(nilLiteral: ()) {
-        self.init(NSNull() as Any)
-    }
-}
-
 // MARK: - Raw

 extension JSON: Swift.RawRepresentable {
@@ -1,16 +1,17 @@
 Pod::Spec.new do |s|
  s.name        = "SwiftyJSON"
-  s.version     = "4.1.0"
+  s.version     = "4.3.0"
  s.summary     = "SwiftyJSON makes it easy to deal with JSON data in Swift"
  s.homepage    = "https://github.com/SwiftyJSON/SwiftyJSON"
  s.license     = { :type => "MIT" }
  s.authors     = { "lingoer" => "lingoerer@gmail.com", "tangplin" => "tangplin@gmail.com" }

  s.requires_arc = true
+  s.swift_version = "5.0"
  s.osx.deployment_target = "10.9"
  s.ios.deployment_target = "8.0"
-  s.watchos.deployment_target = "2.0"
+  s.watchos.deployment_target = "3.0"
  s.tvos.deployment_target = "9.0"
  s.source   = { :git => "https://github.com/SwiftyJSON/SwiftyJSON.git", :tag => s.version }
-  s.source_files = "Source/*.swift"
+  s.source_files = "Source/SwiftyJSON/*.swift"
 end
@@ -114,37 +114,37 @@

 /* Begin PBXFileReference section */
 		030B6CDC1A6E171D00C2D4F1 /* Info-macOS.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = "Info-macOS.plist"; sourceTree = "<group>"; };
-		1B587CC41DDE04360012D8DB /* MergeTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MergeTests.swift; sourceTree = "<group>"; };
+		1B587CC41DDE04360012D8DB /* MergeTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = MergeTests.swift; path = ../SwiftJSONTests/MergeTests.swift; sourceTree = "<group>"; };
 		2E4FEFDB19575BE100351305 /* SwiftyJSON.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = SwiftyJSON.framework; sourceTree = BUILT_PRODUCTS_DIR; };
 		2E4FEFDF19575BE100351305 /* Info-iOS.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = "Info-iOS.plist"; sourceTree = "<group>"; };
-		2E4FEFE019575BE100351305 /* SwiftyJSON.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SwiftyJSON.h; sourceTree = "<group>"; };
+		2E4FEFE019575BE100351305 /* SwiftyJSON.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SwiftyJSON.h; path = SwiftyJSON/SwiftyJSON.h; sourceTree = "<group>"; };
 		2E4FEFE619575BE100351305 /* SwiftyJSON iOS Tests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "SwiftyJSON iOS Tests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
-		5DD502901D9B21810004C112 /* NestedJSONTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = NestedJSONTests.swift; sourceTree = "<group>"; };
-		712921EE2004E4EB00DA6340 /* CodableTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CodableTests.swift; sourceTree = "<group>"; };
+		5DD502901D9B21810004C112 /* NestedJSONTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = NestedJSONTests.swift; path = ../SwiftJSONTests/NestedJSONTests.swift; sourceTree = "<group>"; };
+		712921EE2004E4EB00DA6340 /* CodableTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = CodableTests.swift; path = ../SwiftJSONTests/CodableTests.swift; sourceTree = "<group>"; };
 		7236B4F61BAC14150020529B /* SwiftyJSON.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = SwiftyJSON.framework; sourceTree = BUILT_PRODUCTS_DIR; };
 		7236B4F71BAC14150020529B /* Info-tvOS.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = "Info-tvOS.plist"; sourceTree = "<group>"; };
-		9C459EF61A9103B1008C9A41 /* Info-macOS.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; path = "Info-macOS.plist"; sourceTree = "<group>"; };
+		9C459EF61A9103B1008C9A41 /* Info-macOS.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = "Info-macOS.plist"; path = "../Info-macOS.plist"; sourceTree = "<group>"; };
 		9C7DFC5B1A9102BD005AA3F7 /* SwiftyJSON.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = SwiftyJSON.framework; sourceTree = BUILT_PRODUCTS_DIR; };
 		9C7DFC651A9102BD005AA3F7 /* SwiftyJSON macOS Tests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "SwiftyJSON macOS Tests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
-		A819C49619E1A7DD00ADCC3D /* LiteralConvertibleTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = LiteralConvertibleTests.swift; sourceTree = "<group>"; };
-		A819C49819E1B10300ADCC3D /* RawRepresentableTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = RawRepresentableTests.swift; sourceTree = "<group>"; };
-		A819C49E19E2EE5B00ADCC3D /* SubscriptTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SubscriptTests.swift; sourceTree = "<group>"; };
-		A819C4A019E37FC600ADCC3D /* PrintableTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = PrintableTests.swift; sourceTree = "<group>"; };
-		A82A1C0D19D922DC009A653D /* Info-iOS.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; path = "Info-iOS.plist"; sourceTree = "<group>"; };
-		A830A6941E5B2DD8001D7F6D /* MutabilityTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MutabilityTests.swift; sourceTree = "<group>"; };
-		A8491E1D19CD6DAE00CCFAE6 /* SwiftyJSON.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SwiftyJSON.swift; sourceTree = "<group>"; };
+		A819C49619E1A7DD00ADCC3D /* LiteralConvertibleTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = LiteralConvertibleTests.swift; path = ../SwiftJSONTests/LiteralConvertibleTests.swift; sourceTree = "<group>"; };
+		A819C49819E1B10300ADCC3D /* RawRepresentableTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = RawRepresentableTests.swift; path = ../SwiftJSONTests/RawRepresentableTests.swift; sourceTree = "<group>"; };
+		A819C49E19E2EE5B00ADCC3D /* SubscriptTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = SubscriptTests.swift; path = ../SwiftJSONTests/SubscriptTests.swift; sourceTree = "<group>"; };
+		A819C4A019E37FC600ADCC3D /* PrintableTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = PrintableTests.swift; path = ../SwiftJSONTests/PrintableTests.swift; sourceTree = "<group>"; };
+		A82A1C0D19D922DC009A653D /* Info-iOS.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = "Info-iOS.plist"; path = "../Info-iOS.plist"; sourceTree = "<group>"; };
+		A830A6941E5B2DD8001D7F6D /* MutabilityTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = MutabilityTests.swift; path = ../SwiftJSONTests/MutabilityTests.swift; sourceTree = "<group>"; };
+		A8491E1D19CD6DAE00CCFAE6 /* SwiftyJSON.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = SwiftyJSON.swift; path = SwiftyJSON/SwiftyJSON.swift; sourceTree = "<group>"; };
 		A8580F741BCF5C5B00DA927B /* SwiftyJSON tvOS Tests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "SwiftyJSON tvOS Tests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
-		A8580F781BCF5C5B00DA927B /* Info-tvOS.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = "Info-tvOS.plist"; sourceTree = "<group>"; };
-		A863BE2719EED46F0092A41F /* RawTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = RawTests.swift; sourceTree = "<group>"; };
-		A86BAA0D19EBC32B009EAAEB /* PerformanceTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = PerformanceTests.swift; sourceTree = "<group>"; };
-		A87080E319E3C2A600CDE086 /* SequenceTypeTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SequenceTypeTests.swift; sourceTree = "<group>"; };
-		A87080E519E3DF7800CDE086 /* ComparableTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ComparableTests.swift; sourceTree = "<group>"; };
-		A87080E719E439DA00CDE086 /* NumberTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = NumberTests.swift; sourceTree = "<group>"; };
-		A87080E919E43C0700CDE086 /* StringTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = StringTests.swift; sourceTree = "<group>"; };
-		A885D1D119CF1EE6002FD4C3 /* BaseTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BaseTests.swift; sourceTree = "<group>"; };
+		A8580F781BCF5C5B00DA927B /* Info-tvOS.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; name = "Info-tvOS.plist"; path = "../Info-tvOS.plist"; sourceTree = "<group>"; };
+		A863BE2719EED46F0092A41F /* RawTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = RawTests.swift; path = ../SwiftJSONTests/RawTests.swift; sourceTree = "<group>"; };
+		A86BAA0D19EBC32B009EAAEB /* PerformanceTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = PerformanceTests.swift; path = ../SwiftJSONTests/PerformanceTests.swift; sourceTree = "<group>"; };
+		A87080E319E3C2A600CDE086 /* SequenceTypeTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = SequenceTypeTests.swift; path = ../SwiftJSONTests/SequenceTypeTests.swift; sourceTree = "<group>"; };
+		A87080E519E3DF7800CDE086 /* ComparableTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = ComparableTests.swift; path = ../SwiftJSONTests/ComparableTests.swift; sourceTree = "<group>"; };
+		A87080E719E439DA00CDE086 /* NumberTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = NumberTests.swift; path = ../SwiftJSONTests/NumberTests.swift; sourceTree = "<group>"; };
+		A87080E919E43C0700CDE086 /* StringTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = StringTests.swift; path = ../SwiftJSONTests/StringTests.swift; sourceTree = "<group>"; };
+		A885D1D119CF1EE6002FD4C3 /* BaseTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = BaseTests.swift; path = ../SwiftJSONTests/BaseTests.swift; sourceTree = "<group>"; };
 		A885D1DA19CFCFF0002FD4C3 /* Tests.json */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.json; path = Tests.json; sourceTree = "<group>"; };
-		A8B66C8B19E51D6500540692 /* DictionaryTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = DictionaryTests.swift; sourceTree = "<group>"; };
-		A8B66C8D19E52F4200540692 /* ArrayTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ArrayTests.swift; sourceTree = "<group>"; };
+		A8B66C8B19E51D6500540692 /* DictionaryTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = DictionaryTests.swift; path = ../SwiftJSONTests/DictionaryTests.swift; sourceTree = "<group>"; };
+		A8B66C8D19E52F4200540692 /* ArrayTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = ArrayTests.swift; path = ../SwiftJSONTests/ArrayTests.swift; sourceTree = "<group>"; };
 		E4D7CCE81B9465A700EE7221 /* SwiftyJSON.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = SwiftyJSON.framework; sourceTree = BUILT_PRODUCTS_DIR; };
 		E4D7CCE91B9465A800EE7221 /* Info-watchOS.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = "Info-watchOS.plist"; sourceTree = "<group>"; };
 /* End PBXFileReference section */
@@ -209,7 +209,7 @@
 			isa = PBXGroup;
 			children = (
 				2E4FEFDD19575BE100351305 /* Source */,
-				2E4FEFEA19575BE100351305 /* SwiftyJSONTests */,
+				2E4FEFEA19575BE100351305 /* Tests */,
 				2E4FEFDC19575BE100351305 /* Products */,
 			);
 			sourceTree = "<group>";
@@ -249,11 +249,10 @@
 			name = "Supporting Files";
 			sourceTree = "<group>";
 		};
-		2E4FEFEA19575BE100351305 /* SwiftyJSONTests */ = {
+		2E4FEFEA19575BE100351305 /* Tests */ = {
 			isa = PBXGroup;
 			children = (
 				1B587CC41DDE04360012D8DB /* MergeTests.swift */,
-				A885D1DA19CFCFF0002FD4C3 /* Tests.json */,
 				A86BAA0D19EBC32B009EAAEB /* PerformanceTests.swift */,
 				A885D1D119CF1EE6002FD4C3 /* BaseTests.swift */,
 				5DD502901D9B21810004C112 /* NestedJSONTests.swift */,
@@ -272,13 +271,14 @@
 				712921EE2004E4EB00DA6340 /* CodableTests.swift */,
 				2E4FEFEB19575BE100351305 /* Supporting Files */,
 			);
-			name = SwiftyJSONTests;
-			path = Tests/SwiftyJSONTests;
+			name = Tests;
+			path = Tests/Tes;
 			sourceTree = "<group>";
 		};
 		2E4FEFEB19575BE100351305 /* Supporting Files */ = {
 			isa = PBXGroup;
 			children = (
+				A885D1DA19CFCFF0002FD4C3 /* Tests.json */,
 				A82A1C0D19D922DC009A653D /* Info-iOS.plist */,
 				9C459EF61A9103B1008C9A41 /* Info-macOS.plist */,
 				A8580F781BCF5C5B00DA927B /* Info-tvOS.plist */,
@@ -457,7 +457,7 @@
 			isa = PBXProject;
 			attributes = {
 				LastSwiftUpdateCheck = 0710;
-				LastUpgradeCheck = 0930;
+				LastUpgradeCheck = 1020;
 				TargetAttributes = {
 					2E4FEFDA19575BE100351305 = {
 						CreatedOnToolsVersion = 6.0;
@@ -471,14 +471,17 @@
 						TestTargetID = 2E4FEFDA19575BE100351305;
 					};
 					7236B4EC1BAC14150020529B = {
+						LastSwiftMigration = 1000;
 						ProvisioningStyle = Automatic;
 					};
 					9C7DFC5A1A9102BD005AA3F7 = {
 						CreatedOnToolsVersion = 6.1.1;
+						LastSwiftMigration = 1000;
 						ProvisioningStyle = Automatic;
 					};
 					9C7DFC641A9102BD005AA3F7 = {
 						CreatedOnToolsVersion = 6.1.1;
+						LastSwiftMigration = 1000;
 					};
 					A81D162B1E5743B000C62C5F = {
 						CreatedOnToolsVersion = 8.2.1;
@@ -486,18 +489,21 @@
 					};
 					A8580F731BCF5C5B00DA927B = {
 						CreatedOnToolsVersion = 7.1;
+						LastSwiftMigration = 1000;
 					};
 					E4D7CCDE1B9465A700EE7221 = {
+						LastSwiftMigration = 1000;
 						ProvisioningStyle = Automatic;
 					};
 				};
 			};
 			buildConfigurationList = 2E4FEFD519575BE100351305 /* Build configuration list for PBXProject "SwiftyJSON" */;
 			compatibilityVersion = "Xcode 3.2";
-			developmentRegion = English;
+			developmentRegion = en;
 			hasScannedForEncodings = 0;
 			knownRegions = (
 				en,
+				Base,
 			);
 			mainGroup = 2E4FEFD119575BE100351305;
 			productRefGroup = 2E4FEFDC19575BE100351305 /* Products */;
@@ -717,6 +723,7 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES;
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
 				CLANG_CXX_LIBRARY = "libc++";
 				CLANG_ENABLE_MODULES = YES;
@@ -777,6 +784,7 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES;
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
 				CLANG_CXX_LIBRARY = "libc++";
 				CLANG_ENABLE_MODULES = YES;
@@ -848,7 +856,7 @@
 				SKIP_INSTALL = YES;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
 				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Debug;
 		};
@@ -872,7 +880,7 @@
 				PRODUCT_NAME = SwiftyJSON;
 				SKIP_INSTALL = YES;
 				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Release;
 		};
@@ -886,7 +894,7 @@
 					"DEBUG=1",
 					"$(inherited)",
 				);
-				INFOPLIST_FILE = "Tests/SwiftyJSONTests/Info-iOS.plist";
+				INFOPLIST_FILE = "Tests/Info-iOS.plist";
 				IPHONEOS_DEPLOYMENT_TARGET = 9.1;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
 				METAL_ENABLE_DEBUG_INFO = YES;
@@ -894,7 +902,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
 				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Debug;
 		};
@@ -904,14 +912,14 @@
 				CODE_SIGN_IDENTITY = "";
 				DEVELOPMENT_TEAM = "";
 				GCC_OPTIMIZATION_LEVEL = s;
-				INFOPLIST_FILE = "Tests/SwiftyJSONTests/Info-iOS.plist";
+				INFOPLIST_FILE = "Tests/Info-iOS.plist";
 				IPHONEOS_DEPLOYMENT_TARGET = 9.1;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
 				METAL_ENABLE_DEBUG_INFO = NO;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.swiftyjson.${PRODUCT_NAME:rfc1034identifier}";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Release;
 		};
@@ -936,6 +944,7 @@
 				SDKROOT = appletvos;
 				SKIP_INSTALL = YES;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
 				TARGETED_DEVICE_FAMILY = 3;
 				TVOS_DEPLOYMENT_TARGET = 9.0;
 			};
@@ -961,6 +970,7 @@
 				PRODUCT_NAME = SwiftyJSON;
 				SDKROOT = appletvos;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.0;
 				TARGETED_DEVICE_FAMILY = 3;
 				TVOS_DEPLOYMENT_TARGET = 9.0;
 			};
@@ -993,6 +1003,7 @@
 				SDKROOT = macosx;
 				SKIP_INSTALL = YES;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
 			};
 			name = Debug;
 		};
@@ -1019,6 +1030,7 @@
 				PRODUCT_NAME = "$(PROJECT_NAME)";
 				SDKROOT = macosx;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Release;
 		};
@@ -1033,7 +1045,7 @@
 					"DEBUG=1",
 					"$(inherited)",
 				);
-				INFOPLIST_FILE = "Tests/SwiftyJSONTests/Info-macOS.plist";
+				INFOPLIST_FILE = "Tests/Info-macOS.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/../Frameworks @loader_path/../Frameworks";
 				MACOSX_DEPLOYMENT_TARGET = 10.10;
 				MTL_ENABLE_DEBUG_INFO = YES;
@@ -1041,6 +1053,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = macosx;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
 			};
 			name = Debug;
 		};
@@ -1052,13 +1065,14 @@
 				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
 				FRAMEWORK_SEARCH_PATHS = "";
 				GCC_OPTIMIZATION_LEVEL = s;
-				INFOPLIST_FILE = "Tests/SwiftyJSONTests/Info-macOS.plist";
+				INFOPLIST_FILE = "Tests/Info-macOS.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/../Frameworks @loader_path/../Frameworks";
 				MACOSX_DEPLOYMENT_TARGET = 10.10;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.swiftyjson.$(PRODUCT_NAME:rfc1034identifier)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = macosx;
+				SWIFT_VERSION = 5.0;
 			};
 			name = Release;
 		};
@@ -1085,13 +1099,14 @@
 				DEBUG_INFORMATION_FORMAT = dwarf;
 				GCC_NO_COMMON_BLOCKS = YES;
 				GCC_OPTIMIZATION_LEVEL = 0;
-				INFOPLIST_FILE = "Tests/SwiftyJSONTests/Info-tvOS.plist";
+				INFOPLIST_FILE = "Tests/Info-tvOS.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
 				MTL_ENABLE_DEBUG_INFO = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.tangplin.SwiftyJSON-tvOS-Tests";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = appletvos;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
 				TVOS_DEPLOYMENT_TARGET = 9.0;
 			};
 			name = Debug;
@@ -1104,12 +1119,13 @@
 				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
 				GCC_NO_COMMON_BLOCKS = YES;
 				GCC_OPTIMIZATION_LEVEL = s;
-				INFOPLIST_FILE = "Tests/SwiftyJSONTests/Info-tvOS.plist";
+				INFOPLIST_FILE = "Tests/Info-tvOS.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
 				MTL_ENABLE_DEBUG_INFO = NO;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.tangplin.SwiftyJSON-tvOS-Tests";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = appletvos;
+				SWIFT_VERSION = 5.0;
 				TVOS_DEPLOYMENT_TARGET = 9.0;
 			};
 			name = Release;
@@ -1136,8 +1152,9 @@
 				SKIP_INSTALL = YES;
 				SUPPORTED_PLATFORMS = "watchsimulator watchos";
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
 				TARGETED_DEVICE_FAMILY = 4;
-				WATCHOS_DEPLOYMENT_TARGET = 2.0;
+				WATCHOS_DEPLOYMENT_TARGET = 3.0;
 			};
 			name = Debug;
 		};
@@ -1162,8 +1179,9 @@
 				SDKROOT = watchos;
 				SKIP_INSTALL = YES;
 				SUPPORTED_PLATFORMS = "watchsimulator watchos";
+				SWIFT_VERSION = 5.0;
 				TARGETED_DEVICE_FAMILY = 4;
-				WATCHOS_DEPLOYMENT_TARGET = 2.0;
+				WATCHOS_DEPLOYMENT_TARGET = 3.0;
 			};
 			name = Release;
 		};
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0930"
+   LastUpgradeVersion = "1020"
   version = "1.3">
   <BuildAction
      parallelizeBuildables = "YES"
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0930"
+   LastUpgradeVersion = "1020"
   version = "1.3">
   <BuildAction
      parallelizeBuildables = "YES"
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0930"
+   LastUpgradeVersion = "1020"
   version = "1.3">
   <BuildAction
      parallelizeBuildables = "YES"
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0930"
+   LastUpgradeVersion = "1020"
   version = "1.3">
   <BuildAction
      parallelizeBuildables = "YES"
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>${EXECUTABLE_NAME}</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>${PRODUCT_NAME}</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+</dict>
+</plist>
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+</dict>
+</plist>
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+</dict>
+</plist>
@@ -0,0 +1,45 @@
+//  ArrayTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class ArrayTests: XCTestCase {
+
+    func testSingleDimensionalArraysGetter() {
+        let array = ["1", "2", "a", "B", "D"]
+        let json = JSON(array)
+        XCTAssertEqual((json.array![0] as JSON).string!, "1")
+        XCTAssertEqual((json.array![1] as JSON).string!, "2")
+        XCTAssertEqual((json.array![2] as JSON).string!, "a")
+        XCTAssertEqual((json.array![3] as JSON).string!, "B")
+        XCTAssertEqual((json.array![4] as JSON).string!, "D")
+    }
+
+    func testSingleDimensionalArraysSetter() {
+        let array = ["1", "2", "a", "B", "D"]
+        var json = JSON(array)
+        json.arrayObject = ["111", "222"]
+        XCTAssertEqual((json.array![0] as JSON).string!, "111")
+        XCTAssertEqual((json.array![1] as JSON).string!, "222")
+    }
+}
@@ -0,0 +1,277 @@
+//  BaseTests.swift
+//
+//  Copyright (c) 2014 - 2017 Ruoyu Fu, Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class BaseTests: XCTestCase {
+
+    var testData: Data!
+
+    override func setUp() {
+
+        super.setUp()
+
+//        let file = "./Tests/Tes/Tests.json"
+//        self.testData = try? Data(contentsOf: URL(fileURLWithPath: file))
+        if let file = Bundle(for: BaseTests.self).path(forResource: "Tests", ofType: "json") {
+            self.testData = try? Data(contentsOf: URL(fileURLWithPath: file))
+        } else {
+            XCTFail("Can't find the test JSON file")
+        }
+    }
+
+    override func tearDown() {
+        super.tearDown()
+    }
+
+    func testInit() {
+        guard let json0 = try? JSON(data: self.testData) else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+        XCTAssertEqual(json0.array!.count, 3)
+        XCTAssertEqual(JSON("123").description, "123")
+        XCTAssertEqual(JSON(["1": "2"])["1"].string!, "2")
+        let dictionary = NSMutableDictionary()
+        dictionary.setObject(NSNumber(value: 1.0), forKey: "number" as NSString)
+        dictionary.setObject(NSNull(), forKey: "null" as NSString)
+        _ = JSON(dictionary)
+        do {
+            let object: Any = try JSONSerialization.jsonObject(with: self.testData, options: [])
+            let json2 = JSON(object)
+            XCTAssertEqual(json0, json2)
+        } catch _ {
+        }
+    }
+
+    func testCompare() {
+        XCTAssertNotEqual(JSON("32.1234567890"), JSON(32.1234567890))
+        let veryLargeNumber: UInt64 = 9876543210987654321
+        XCTAssertNotEqual(JSON("9876543210987654321"), JSON(NSNumber(value: veryLargeNumber)))
+        XCTAssertNotEqual(JSON("9876543210987654321.12345678901234567890"), JSON(9876543210987654321.12345678901234567890))
+        XCTAssertEqual(JSON("😊"), JSON("😊"))
+        XCTAssertNotEqual(JSON("😱"), JSON("😁"))
+        XCTAssertEqual(JSON([123, 321, 456]), JSON([123, 321, 456]))
+        XCTAssertNotEqual(JSON([123, 321, 456]), JSON(123456789))
+        XCTAssertNotEqual(JSON([123, 321, 456]), JSON("string"))
+        XCTAssertNotEqual(JSON(["1": 123, "2": 321, "3": 456]), JSON("string"))
+        XCTAssertEqual(JSON(["1": 123, "2": 321, "3": 456]), JSON(["2": 321, "1": 123, "3": 456]))
+        XCTAssertEqual(JSON(NSNull()), JSON(NSNull()))
+        XCTAssertNotEqual(JSON(NSNull()), JSON(123))
+    }
+
+    func testJSONDoesProduceValidWithCorrectKeyPath() {
+
+        guard let json = try? JSON(data: self.testData) else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+
+        let tweets = json
+        let tweets_array = json.array
+        let tweets_1 = json[1]
+        _ = tweets_1[1]
+        let tweets_1_user_name = tweets_1["user"]["name"]
+        let tweets_1_user_name_string = tweets_1["user"]["name"].string
+        XCTAssertNotEqual(tweets.type, Type.null)
+        XCTAssert(tweets_array != nil)
+        XCTAssertNotEqual(tweets_1.type, Type.null)
+        XCTAssertEqual(tweets_1_user_name, JSON("Raffi Krikorian"))
+        XCTAssertEqual(tweets_1_user_name_string!, "Raffi Krikorian")
+
+        let tweets_1_coordinates = tweets_1["coordinates"]
+        let tweets_1_coordinates_coordinates = tweets_1_coordinates["coordinates"]
+        let tweets_1_coordinates_coordinates_point_0_double = tweets_1_coordinates_coordinates[0].double
+        let tweets_1_coordinates_coordinates_point_1_float = tweets_1_coordinates_coordinates[1].float
+        let new_tweets_1_coordinates_coordinates = JSON([-122.25831, 37.871609] as NSArray)
+        XCTAssertEqual(tweets_1_coordinates_coordinates, new_tweets_1_coordinates_coordinates)
+        XCTAssertEqual(tweets_1_coordinates_coordinates_point_0_double!, -122.25831)
+        XCTAssertTrue(tweets_1_coordinates_coordinates_point_1_float! == 37.871609)
+        let tweets_1_coordinates_coordinates_point_0_string = tweets_1_coordinates_coordinates[0].stringValue
+        let tweets_1_coordinates_coordinates_point_1_string = tweets_1_coordinates_coordinates[1].stringValue
+        XCTAssertEqual(tweets_1_coordinates_coordinates_point_0_string, "-122.25831")
+        XCTAssertEqual(tweets_1_coordinates_coordinates_point_1_string, "37.871609")
+        let tweets_1_coordinates_coordinates_point_0 = tweets_1_coordinates_coordinates[0]
+        let tweets_1_coordinates_coordinates_point_1 = tweets_1_coordinates_coordinates[1]
+        XCTAssertEqual(tweets_1_coordinates_coordinates_point_0, JSON(-122.25831))
+        XCTAssertEqual(tweets_1_coordinates_coordinates_point_1, JSON(37.871609))
+
+        let created_at = json[0]["created_at"].string
+        let id_str = json[0]["id_str"].string
+        let favorited = json[0]["favorited"].bool
+        let id = json[0]["id"].int64
+        let in_reply_to_user_id_str = json[0]["in_reply_to_user_id_str"]
+        XCTAssertEqual(created_at!, "Tue Aug 28 21:16:23 +0000 2012")
+        XCTAssertEqual(id_str!, "240558470661799936")
+        XCTAssertFalse(favorited!)
+        XCTAssertEqual(id!, 240558470661799936)
+        XCTAssertEqual(in_reply_to_user_id_str.type, Type.null)
+
+        let user = json[0]["user"]
+        let user_name = user["name"].string
+        let user_profile_image_url = user["profile_image_url"].url
+        XCTAssert(user_name == "OAuth Dancer")
+        XCTAssert(user_profile_image_url == URL(string: "http://a0.twimg.com/profile_images/730275945/oauth-dancer_normal.jpg"))
+
+        let user_dictionary = json[0]["user"].dictionary
+        let user_dictionary_name = user_dictionary?["name"]?.string
+        let user_dictionary_name_profile_image_url = user_dictionary?["profile_image_url"]?.url
+        XCTAssert(user_dictionary_name == "OAuth Dancer")
+        XCTAssert(user_dictionary_name_profile_image_url == URL(string: "http://a0.twimg.com/profile_images/730275945/oauth-dancer_normal.jpg"))
+    }
+
+    func testJSONNumberCompare() {
+        XCTAssertEqual(JSON(12376352.123321), JSON(12376352.123321))
+        XCTAssertGreaterThan(JSON(20.211), JSON(20.112))
+        XCTAssertGreaterThanOrEqual(JSON(30.211), JSON(20.112))
+        XCTAssertGreaterThanOrEqual(JSON(65232), JSON(65232))
+        XCTAssertLessThan(JSON(-82320.211), JSON(20.112))
+        XCTAssertLessThanOrEqual(JSON(-320.211), JSON(123.1))
+        XCTAssertLessThanOrEqual(JSON(-8763), JSON(-8763))
+
+        XCTAssertEqual(JSON(12376352.123321), JSON(12376352.123321))
+        XCTAssertGreaterThan(JSON(20.211), JSON(20.112))
+        XCTAssertGreaterThanOrEqual(JSON(30.211), JSON(20.112))
+        XCTAssertGreaterThanOrEqual(JSON(65232), JSON(65232))
+        XCTAssertLessThan(JSON(-82320.211), JSON(20.112))
+        XCTAssertLessThanOrEqual(JSON(-320.211), JSON(123.1))
+        XCTAssertLessThanOrEqual(JSON(-8763), JSON(-8763))
+    }
+
+    func testNumberConvertToString() {
+        XCTAssertEqual(JSON(true).stringValue, "true")
+        XCTAssertEqual(JSON(999.9823).stringValue, "999.9823")
+        XCTAssertEqual(JSON(true).number!.stringValue, "1")
+        XCTAssertEqual(JSON(false).number!.stringValue, "0")
+        XCTAssertEqual(JSON("hello").numberValue.stringValue, "0")
+        XCTAssertEqual(JSON(NSNull()).numberValue.stringValue, "0")
+        XCTAssertEqual(JSON(["a", "b", "c", "d"]).numberValue.stringValue, "0")
+        XCTAssertEqual(JSON(["a": "b", "c": "d"]).numberValue.stringValue, "0")
+    }
+
+    func testNumberPrint() {
+
+        XCTAssertEqual(JSON(false).description, "false")
+        XCTAssertEqual(JSON(true).description, "true")
+
+        XCTAssertEqual(JSON(1).description, "1")
+        XCTAssertEqual(JSON(22).description, "22")
+        #if (arch(x86_64) || arch(arm64))
+        XCTAssertEqual(JSON(9.22337203685478E18).description, "9.22337203685478e+18")
+        #elseif (arch(i386) || arch(arm))
+        XCTAssertEqual(JSON(2147483647).description, "2147483647")
+        #endif
+        XCTAssertEqual(JSON(-1).description, "-1")
+        XCTAssertEqual(JSON(-934834834).description, "-934834834")
+        XCTAssertEqual(JSON(-2147483648).description, "-2147483648")
+
+        XCTAssertEqual(JSON(1.5555).description, "1.5555")
+        XCTAssertEqual(JSON(-9.123456789).description, "-9.123456789")
+        XCTAssertEqual(JSON(-0.00000000000000001).description, "-1e-17")
+        XCTAssertEqual(JSON(-999999999999999999999999.000000000000000000000001).description, "-1e+24")
+        XCTAssertEqual(JSON(-9999999991999999999999999.88888883433343439438493483483943948341).stringValue, "-9.999999991999999e+24")
+
+        XCTAssertEqual(JSON(Int(Int.max)).description, "\(Int.max)")
+        XCTAssertEqual(JSON(NSNumber(value: Int.min)).description, "\(Int.min)")
+        XCTAssertEqual(JSON(NSNumber(value: UInt.max)).description, "\(UInt.max)")
+        XCTAssertEqual(JSON(NSNumber(value: UInt64.max)).description, "\(UInt64.max)")
+        XCTAssertEqual(JSON(NSNumber(value: Int64.max)).description, "\(Int64.max)")
+        XCTAssertEqual(JSON(NSNumber(value: UInt64.max)).description, "\(UInt64.max)")
+
+        XCTAssertEqual(JSON(Double.infinity).description, "inf")
+        XCTAssertEqual(JSON(-Double.infinity).description, "-inf")
+        XCTAssertEqual(JSON(Double.nan).description, "nan")
+
+        XCTAssertEqual(JSON(1.0/0.0).description, "inf")
+        XCTAssertEqual(JSON(-1.0/0.0).description, "-inf")
+        XCTAssertEqual(JSON(0.0/0.0).description, "nan")
+    }
+
+    func testNullJSON() {
+        XCTAssertEqual(JSON(NSNull()).debugDescription, "null")
+
+        let json: JSON = JSON.null
+        XCTAssertEqual(json.debugDescription, "null")
+        XCTAssertNil(json.error)
+        let json1: JSON = JSON(NSNull())
+        if json1 != JSON.null {
+            XCTFail("json1 should be nil")
+        }
+    }
+
+    func testExistance() {
+        let dictionary = ["number": 1111]
+        let json = JSON(dictionary)
+        XCTAssertFalse(json["unspecifiedValue"].exists())
+        XCTAssertFalse(json[0].exists())
+        XCTAssertTrue(json["number"].exists())
+
+        let array = [["number": 1111]]
+        let jsonForArray = JSON(array)
+        XCTAssertTrue(jsonForArray[0].exists())
+        XCTAssertFalse(jsonForArray[1].exists())
+        XCTAssertFalse(jsonForArray["someValue"].exists())
+    }
+
+    func testErrorHandle() {
+        guard let json = try? JSON(data: self.testData) else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+        if json["wrong-type"].string != nil {
+            XCTFail("Should not run into here")
+        } else {
+            XCTAssertEqual(json["wrong-type"].error, SwiftyJSONError.wrongType)
+        }
+
+        if json[0]["not-exist"].string != nil {
+            XCTFail("Should not run into here")
+        } else {
+            XCTAssertEqual(json[0]["not-exist"].error, SwiftyJSONError.notExist)
+        }
+
+        let wrongJSON = JSON(NSObject())
+        if let error = wrongJSON.error {
+            XCTAssertEqual(error, SwiftyJSONError.unsupportedType)
+        }
+    }
+
+    func testReturnObject() {
+        guard let json = try? JSON(data: self.testData) else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+        XCTAssertNotNil(json.object)
+    }
+
+    func testErrorThrowing() {
+        let invalidJson = "{\"foo\": 300]"  // deliberately incorrect JSON
+        let invalidData = invalidJson.data(using: .utf8)!
+        do {
+            _ = try JSON(data: invalidData)
+            XCTFail("Should have thrown error; we should not have gotten here")
+        } catch {
+            // everything is OK
+        }
+    }
+}
@@ -0,0 +1,104 @@
+//  CodableTests.swift
+//
+//  Created by Lei Wang on 2018/1/9.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class CodableTests: XCTestCase {
+
+    func testEncodeNull() {
+        var json = JSON([NSNull()])
+        _ = try! JSONEncoder().encode(json)
+        json = JSON([nil])
+        _ = try! JSONEncoder().encode(json)
+        let dictionary: [String: Any?] = ["key": nil]
+        json = JSON(dictionary)
+        _ = try! JSONEncoder().encode(json)
+    }
+
+    func testArrayCodable() {
+        let jsonString = """
+        [1,"false", ["A", 4.3231],"3",true]
+        """
+        var data = jsonString.data(using: .utf8)!
+        let json = try! JSONDecoder().decode(JSON.self, from: data)
+        XCTAssertEqual(json.arrayValue.first?.int, 1)
+        XCTAssertEqual(json[1].bool, nil)
+        XCTAssertEqual(json[1].string, "false")
+        XCTAssertEqual(json[3].string, "3")
+        XCTAssertEqual(json[2][1].double!, 4.3231)
+        XCTAssertEqual(json.arrayValue[0].bool, nil)
+        XCTAssertEqual(json.array!.last!.bool, true)
+        let jsonList = try! JSONDecoder().decode([JSON].self, from: data)
+        XCTAssertEqual(jsonList.first?.int, 1)
+        XCTAssertEqual(jsonList.last!.bool, true)
+        data = try! JSONEncoder().encode(json)
+        let list = try! JSONSerialization.jsonObject(with: data, options: []) as! [Any]
+        XCTAssertEqual(list[0] as! Int, 1)
+        XCTAssertEqual((list[2] as! [Any])[1] as! NSNumber, 4.3231)
+    }
+
+    func testDictionaryCodable() {
+        let dictionary: [String: Any] = ["number": 9823.212, "name": "NAME", "list": [1234, 4.21223256], "object": ["sub_number": 877.2323, "sub_name": "sub_name"], "bool": true]
+        var data = try! JSONSerialization.data(withJSONObject: dictionary, options: [])
+        let json = try! JSONDecoder().decode(JSON.self, from: data)
+        XCTAssertNotNil(json.dictionary)
+        XCTAssertEqual(json["number"].float, 9823.212)
+        XCTAssertEqual(json["list"].arrayObject is [NSNumber], true)
+        XCTAssertEqual(json["object"]["sub_number"].float, 877.2323)
+        XCTAssertEqual(json["bool"].bool, true)
+        let jsonDict = try! JSONDecoder().decode([String: JSON].self, from: data)
+        XCTAssertEqual(jsonDict["number"]?.int, 9823)
+        XCTAssertEqual(jsonDict["object"]?["sub_name"], "sub_name")
+        data = try! JSONEncoder().encode(json)
+        var encoderDict = try! JSONSerialization.jsonObject(with: data, options: []) as! [String: Any]
+        XCTAssertEqual(encoderDict["list"] as! [NSNumber], [1234, 4.21223256])
+        XCTAssertEqual(encoderDict["bool"] as! Bool, true)
+        data = try! JSONEncoder().encode(jsonDict)
+        encoderDict = try! JSONSerialization.jsonObject(with: data, options: []) as! [String: Any]
+        XCTAssertEqual(encoderDict["name"] as! String, dictionary["name"] as! String)
+        XCTAssertEqual((encoderDict["object"] as! [String: Any])["sub_number"] as! NSNumber, 877.2323)
+    }
+
+    func testCodableModel() {
+        let dictionary: [String: Any] = [
+            "number": 9823.212,
+            "name": "NAME",
+            "list": [1234, 4.21223256],
+            "object": ["sub_number": 877.2323, "sub_name": "sub_name"],
+            "bool": true]
+        let data = try! JSONSerialization.data(withJSONObject: dictionary, options: [])
+        let model = try! JSONDecoder().decode(CodableModel.self, from: data)
+        XCTAssertEqual(model.subName, "sub_name")
+    }
+}
+
+private struct CodableModel: Codable {
+    let name: String
+    let number: Double
+    let bool: Bool
+    let list: [Double]
+    private let object: JSON
+    var subName: String? {
+        return object["sub_name"].string
+    }
+}
@@ -0,0 +1,337 @@
+//  ComparableTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class ComparableTests: XCTestCase {
+
+    func testNumberEqual() {
+        let jsonL1: JSON = 1234567890.876623
+        let jsonR1: JSON = JSON(1234567890.876623)
+        XCTAssertEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 == 1234567890.876623)
+
+        let jsonL2: JSON = 987654321
+        let jsonR2: JSON = JSON(987654321)
+        XCTAssertEqual(jsonL2, jsonR2)
+        XCTAssertTrue(jsonR2 == 987654321)
+
+        let jsonL3: JSON = JSON(NSNumber(value: 87654321.12345678))
+        let jsonR3: JSON = JSON(NSNumber(value: 87654321.12345678))
+        XCTAssertEqual(jsonL3, jsonR3)
+        XCTAssertTrue(jsonR3 == 87654321.12345678)
+    }
+
+    func testNumberNotEqual() {
+        let jsonL1: JSON = 1234567890.876623
+        let jsonR1: JSON = JSON(123.123)
+        XCTAssertNotEqual(jsonL1, jsonR1)
+        XCTAssertFalse(jsonL1 == 34343)
+
+        let jsonL2: JSON = 8773
+        let jsonR2: JSON = JSON(123.23)
+        XCTAssertNotEqual(jsonL2, jsonR2)
+        XCTAssertFalse(jsonR1 == 454352)
+
+        let jsonL3: JSON = JSON(NSNumber(value: 87621.12345678))
+        let jsonR3: JSON = JSON(NSNumber(value: 87654321.45678))
+        XCTAssertNotEqual(jsonL3, jsonR3)
+        XCTAssertFalse(jsonL3 == 4545.232)
+    }
+
+    func testNumberGreaterThanOrEqual() {
+        let jsonL1: JSON = 1234567890.876623
+        let jsonR1: JSON = JSON(123.123)
+        XCTAssertGreaterThanOrEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 >= -37434)
+
+        let jsonL2: JSON = 8773
+        let jsonR2: JSON = JSON(-87343)
+        XCTAssertGreaterThanOrEqual(jsonL2, jsonR2)
+        XCTAssertTrue(jsonR2 >= -988343)
+
+        let jsonL3: JSON = JSON(NSNumber(value: 87621.12345678))
+        let jsonR3: JSON = JSON(NSNumber(value: 87621.12345678))
+        XCTAssertGreaterThanOrEqual(jsonL3, jsonR3)
+        XCTAssertTrue(jsonR3 >= 0.3232)
+    }
+
+    func testNumberLessThanOrEqual() {
+        let jsonL1: JSON = 1234567890.876623
+        let jsonR1: JSON = JSON(123.123)
+        XCTAssertLessThanOrEqual(jsonR1, jsonL1)
+        XCTAssertFalse(83487343.3493 <= jsonR1)
+
+        let jsonL2: JSON = 8773
+        let jsonR2: JSON = JSON(-123.23)
+        XCTAssertLessThanOrEqual(jsonR2, jsonL2)
+        XCTAssertFalse(9348343 <= jsonR2)
+
+        let jsonL3: JSON = JSON(NSNumber(value: 87621.12345678))
+        let jsonR3: JSON = JSON(NSNumber(value: 87621.12345678))
+        XCTAssertLessThanOrEqual(jsonR3, jsonL3)
+        XCTAssertTrue(87621.12345678 <= jsonR3)
+    }
+
+    func testNumberGreaterThan() {
+        let jsonL1: JSON = 1234567890.876623
+        let jsonR1: JSON = JSON(123.123)
+        XCTAssertGreaterThan(jsonL1, jsonR1)
+        XCTAssertFalse(jsonR1 > 192388843.0988)
+
+        let jsonL2: JSON = 8773
+        let jsonR2: JSON = JSON(123.23)
+        XCTAssertGreaterThan(jsonL2, jsonR2)
+        XCTAssertFalse(jsonR2 > 877434)
+
+        let jsonL3: JSON = JSON(NSNumber(value: 87621.12345678))
+        let jsonR3: JSON = JSON(NSNumber(value: 87621.1234567))
+        XCTAssertGreaterThan(jsonL3, jsonR3)
+        XCTAssertFalse(-7799 > jsonR3)
+    }
+
+    func testNumberLessThan() {
+        let jsonL1: JSON = 1234567890.876623
+        let jsonR1: JSON = JSON(123.123)
+        XCTAssertLessThan(jsonR1, jsonL1)
+        XCTAssertTrue(jsonR1 < 192388843.0988)
+
+        let jsonL2: JSON = 8773
+        let jsonR2: JSON = JSON(123.23)
+        XCTAssertLessThan(jsonR2, jsonL2)
+        XCTAssertTrue(jsonR2 < 877434)
+
+        let jsonL3: JSON = JSON(NSNumber(value: 87621.12345678))
+        let jsonR3: JSON = JSON(NSNumber(value: 87621.1234567))
+        XCTAssertLessThan(jsonR3, jsonL3)
+        XCTAssertTrue(-7799 < jsonR3)
+    }
+
+    func testBoolEqual() {
+        let jsonL1: JSON = true
+        let jsonR1: JSON = JSON(true)
+        XCTAssertEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 == true)
+
+        let jsonL2: JSON = false
+        let jsonR2: JSON = JSON(false)
+        XCTAssertEqual(jsonL2, jsonR2)
+        XCTAssertTrue(jsonL2 == false)
+    }
+
+    func testBoolNotEqual() {
+        let jsonL1: JSON = true
+        let jsonR1: JSON = JSON(false)
+        XCTAssertNotEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 != false)
+
+        let jsonL2: JSON = false
+        let jsonR2: JSON = JSON(true)
+        XCTAssertNotEqual(jsonL2, jsonR2)
+        XCTAssertTrue(jsonL2 != true)
+    }
+
+    func testBoolGreaterThanOrEqual() {
+        let jsonL1: JSON = true
+        let jsonR1: JSON = JSON(true)
+        XCTAssertGreaterThanOrEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 >= true)
+
+        let jsonL2: JSON = false
+        let jsonR2: JSON = JSON(false)
+        XCTAssertGreaterThanOrEqual(jsonL2, jsonR2)
+        XCTAssertFalse(jsonL2 >= true)
+    }
+
+    func testBoolLessThanOrEqual() {
+        let jsonL1: JSON = true
+        let jsonR1: JSON = JSON(true)
+        XCTAssertLessThanOrEqual(jsonL1, jsonR1)
+        XCTAssertTrue(true <= jsonR1)
+
+        let jsonL2: JSON = false
+        let jsonR2: JSON = JSON(false)
+        XCTAssertLessThanOrEqual(jsonL2, jsonR2)
+        XCTAssertFalse(jsonL2 <= true)
+    }
+
+    func testBoolGreaterThan() {
+        let jsonL1: JSON = true
+        let jsonR1: JSON = JSON(true)
+        XCTAssertFalse(jsonL1 > jsonR1)
+        XCTAssertFalse(jsonL1 > true)
+        XCTAssertFalse(jsonR1 > false)
+
+        let jsonL2: JSON = false
+        let jsonR2: JSON = JSON(false)
+        XCTAssertFalse(jsonL2 > jsonR2)
+        XCTAssertFalse(jsonL2 > false)
+        XCTAssertFalse(jsonR2 > true)
+
+        let jsonL3: JSON = true
+        let jsonR3: JSON = JSON(false)
+        XCTAssertFalse(jsonL3 > jsonR3)
+        XCTAssertFalse(jsonL3 > false)
+        XCTAssertFalse(jsonR3 > true)
+
+        let jsonL4: JSON = false
+        let jsonR4: JSON = JSON(true)
+        XCTAssertFalse(jsonL4 > jsonR4)
+        XCTAssertFalse(jsonL4 > false)
+        XCTAssertFalse(jsonR4 > true)
+    }
+
+    func testBoolLessThan() {
+        let jsonL1: JSON = true
+        let jsonR1: JSON = JSON(true)
+        XCTAssertFalse(jsonL1 < jsonR1)
+        XCTAssertFalse(jsonL1 < true)
+        XCTAssertFalse(jsonR1 < false)
+
+        let jsonL2: JSON = false
+        let jsonR2: JSON = JSON(false)
+        XCTAssertFalse(jsonL2 < jsonR2)
+        XCTAssertFalse(jsonL2 < false)
+        XCTAssertFalse(jsonR2 < true)
+
+        let jsonL3: JSON = true
+        let jsonR3: JSON = JSON(false)
+        XCTAssertFalse(jsonL3 < jsonR3)
+        XCTAssertFalse(jsonL3 < false)
+        XCTAssertFalse(jsonR3 < true)
+
+        let jsonL4: JSON = false
+        let jsonR4: JSON = JSON(true)
+        XCTAssertFalse(jsonL4 < jsonR4)
+        XCTAssertFalse(jsonL4 < false)
+        XCTAssertFalse(true < jsonR4)
+    }
+
+    func testStringEqual() {
+        let jsonL1: JSON = "abcdefg 123456789 !@#$%^&*()"
+        let jsonR1: JSON = JSON("abcdefg 123456789 !@#$%^&*()")
+
+        XCTAssertEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 == "abcdefg 123456789 !@#$%^&*()")
+    }
+
+    func testStringNotEqual() {
+        let jsonL1: JSON = "abcdefg 123456789 !@#$%^&*()"
+        let jsonR1: JSON = JSON("-=[]\\\"987654321")
+
+        XCTAssertNotEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 != "not equal")
+    }
+
+    func testStringGreaterThanOrEqual() {
+        let jsonL1: JSON = "abcdefg 123456789 !@#$%^&*()"
+        let jsonR1: JSON = JSON("abcdefg 123456789 !@#$%^&*()")
+
+        XCTAssertGreaterThanOrEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 >= "abcdefg 123456789 !@#$%^&*()")
+
+        let jsonL2: JSON = "z-+{}:"
+        let jsonR2: JSON = JSON("a<>?:")
+        XCTAssertGreaterThanOrEqual(jsonL2, jsonR2)
+        XCTAssertTrue(jsonL2 >= "mnbvcxz")
+    }
+
+    func testStringLessThanOrEqual() {
+        let jsonL1: JSON = "abcdefg 123456789 !@#$%^&*()"
+        let jsonR1: JSON = JSON("abcdefg 123456789 !@#$%^&*()")
+
+        XCTAssertLessThanOrEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 <= "abcdefg 123456789 !@#$%^&*()")
+
+        let jsonL2: JSON = "z-+{}:"
+        let jsonR2: JSON = JSON("a<>?:")
+        XCTAssertLessThanOrEqual(jsonR2, jsonL2)
+        XCTAssertTrue("mnbvcxz" <= jsonL2)
+    }
+
+    func testStringGreaterThan() {
+        let jsonL1: JSON = "abcdefg 123456789 !@#$%^&*()"
+        let jsonR1: JSON = JSON("abcdefg 123456789 !@#$%^&*()")
+
+        XCTAssertFalse(jsonL1 > jsonR1)
+        XCTAssertFalse(jsonL1 > "abcdefg 123456789 !@#$%^&*()")
+
+        let jsonL2: JSON = "z-+{}:"
+        let jsonR2: JSON = JSON("a<>?:")
+        XCTAssertGreaterThan(jsonL2, jsonR2)
+        XCTAssertFalse("87663434" > jsonL2)
+    }
+
+    func testStringLessThan() {
+        let jsonL1: JSON = "abcdefg 123456789 !@#$%^&*()"
+        let jsonR1: JSON = JSON("abcdefg 123456789 !@#$%^&*()")
+
+        XCTAssertFalse(jsonL1 < jsonR1)
+        XCTAssertFalse(jsonL1 < "abcdefg 123456789 !@#$%^&*()")
+
+        let jsonL2: JSON = "98774"
+        let jsonR2: JSON = JSON("123456")
+        XCTAssertLessThan(jsonR2, jsonL2)
+        XCTAssertFalse(jsonL2 < "09")
+    }
+
+    func testNil() {
+        let jsonL1: JSON = JSON.null
+        let jsonR1: JSON = JSON(NSNull())
+        XCTAssertEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 != "123")
+        XCTAssertFalse(jsonL1 > "abcd")
+        XCTAssertFalse(jsonR1 < "*&^")
+        XCTAssertFalse(jsonL1 >= "jhfid")
+        XCTAssertFalse(jsonR1 <= "你好")
+        XCTAssertTrue(jsonL1 >= jsonR1)
+        XCTAssertTrue(jsonL1 <= jsonR1)
+    }
+
+    func testArray() {
+        let jsonL1: JSON = [1, 2, "4", 5, "6"]
+        let jsonR1: JSON = JSON([1, 2, "4", 5, "6"])
+        XCTAssertEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 == [1, 2, "4", 5, "6"])
+        XCTAssertTrue(jsonL1 != ["abcd", "efg"])
+        XCTAssertTrue(jsonL1 >= jsonR1)
+        XCTAssertTrue(jsonL1 <= jsonR1)
+        XCTAssertFalse(jsonL1 > ["abcd", ""])
+        XCTAssertFalse(jsonR1 < [])
+        XCTAssertFalse(jsonL1 >= [:])
+    }
+
+    func testDictionary() {
+        let jsonL1: JSON = ["2": 2, "name": "Jack", "List": ["a", 1.09, NSNull()]]
+        let jsonR1: JSON = JSON(["2": 2, "name": "Jack", "List": ["a", 1.09, NSNull()]])
+
+        XCTAssertEqual(jsonL1, jsonR1)
+        XCTAssertTrue(jsonL1 != ["1": 2, "Hello": "World", "Koo": "Foo"])
+        XCTAssertTrue(jsonL1 >= jsonR1)
+        XCTAssertTrue(jsonL1 <= jsonR1)
+        XCTAssertFalse(jsonL1 >= [:])
+        XCTAssertFalse(jsonR1 <= ["999": "aaaa"])
+        XCTAssertFalse(jsonL1 > [")(*&^": 1234567])
+        XCTAssertFalse(jsonR1 < ["MNHH": "JUYTR"])
+    }
+}
@@ -0,0 +1,55 @@
+//  DictionaryTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class DictionaryTests: XCTestCase {
+
+    func testGetter() {
+        let dictionary = ["number": 9823.212, "name": "NAME", "list": [1234, 4.212], "object": ["sub_number": 877.2323, "sub_name": "sub_name"], "bool": true] as [String: Any]
+        let json = JSON(dictionary)
+        //dictionary
+        XCTAssertEqual((json.dictionary!["number"]! as JSON).double!, 9823.212)
+        XCTAssertEqual((json.dictionary!["name"]! as JSON).string!, "NAME")
+        XCTAssertEqual(((json.dictionary!["list"]! as JSON).array![0] as JSON).int!, 1234)
+        XCTAssertEqual(((json.dictionary!["list"]! as JSON).array![1] as JSON).double!, 4.212)
+        XCTAssertEqual((((json.dictionary!["object"]! as JSON).dictionaryValue)["sub_number"]! as JSON).double!, 877.2323)
+        XCTAssertTrue(json.dictionary!["null"] == nil)
+        //dictionaryValue
+        XCTAssertEqual(((((json.dictionaryValue)["object"]! as JSON).dictionaryValue)["sub_name"]! as JSON).string!, "sub_name")
+        XCTAssertEqual((json.dictionaryValue["bool"]! as JSON).bool!, true)
+        XCTAssertTrue(json.dictionaryValue["null"] == nil)
+        XCTAssertTrue(JSON.null.dictionaryValue == [:])
+        //dictionaryObject
+        XCTAssertEqual(json.dictionaryObject!["number"]! as? Double, 9823.212)
+        XCTAssertTrue(json.dictionaryObject!["null"] == nil)
+        XCTAssertTrue(JSON.null.dictionaryObject == nil)
+    }
+
+    func testSetter() {
+        var json: JSON = ["test": "case"]
+        XCTAssertEqual(json.dictionaryObject! as! [String: String], ["test": "case"])
+        json.dictionaryObject = ["name": "NAME"]
+        XCTAssertEqual(json.dictionaryObject! as! [String: String], ["name": "NAME"])
+    }
+}
@@ -0,0 +1,73 @@
+//  LiteralConvertibleTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class LiteralConvertibleTests: XCTestCase {
+
+    func testNumber() {
+        var json: JSON = 1234567890.876623
+        XCTAssertEqual(json.int!, 1234567890)
+        XCTAssertEqual(json.intValue, 1234567890)
+        XCTAssertEqual(json.double!, 1234567890.876623)
+        XCTAssertEqual(json.doubleValue, 1234567890.876623)
+        XCTAssertTrue(json.float! == 1234567890.876623)
+        XCTAssertTrue(json.floatValue == 1234567890.876623)
+    }
+
+    func testBool() {
+        var jsonTrue: JSON = true
+        XCTAssertEqual(jsonTrue.bool!, true)
+        XCTAssertEqual(jsonTrue.boolValue, true)
+        var jsonFalse: JSON = false
+        XCTAssertEqual(jsonFalse.bool!, false)
+        XCTAssertEqual(jsonFalse.boolValue, false)
+    }
+
+    func testString() {
+        var json: JSON = "abcd efg, HIJK;LMn"
+        XCTAssertEqual(json.string!, "abcd efg, HIJK;LMn")
+        XCTAssertEqual(json.stringValue, "abcd efg, HIJK;LMn")
+    }
+
+    func testNil() {
+        let jsonNil_1: JSON = JSON.null
+        XCTAssert(jsonNil_1 == JSON.null)
+        let jsonNil_2: JSON = JSON(NSNull.self)
+        XCTAssert(jsonNil_2 != JSON.null)
+        let jsonNil_3: JSON = JSON([1: 2])
+        XCTAssert(jsonNil_3 != JSON.null)
+    }
+
+    func testArray() {
+        let json: JSON = [1, 2, "4", 5, "6"]
+        XCTAssertEqual(json.array!, [1, 2, "4", 5, "6"])
+        XCTAssertEqual(json.arrayValue, [1, 2, "4", 5, "6"])
+    }
+
+    func testDictionary() {
+        let json: JSON = ["1": 2, "2": 2, "three": 3, "list": ["aa", "bb", "dd"]]
+        XCTAssertEqual(json.dictionary!, ["1": 2, "2": 2, "three": 3, "list": ["aa", "bb", "dd"]])
+        XCTAssertEqual(json.dictionaryValue, ["1": 2, "2": 2, "three": 3, "list": ["aa", "bb", "dd"]])
+    }
+}
@@ -0,0 +1,97 @@
+//  MergeTests.swift
+//
+//  Created by Daniel Kiedrowski on 17.11.16.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class MergeTests: XCTestCase {
+
+    func testDifferingTypes() {
+        let A = JSON("a")
+        let B = JSON(1)
+
+        do {
+            _ = try A.merged(with: B)
+        } catch let error as SwiftyJSONError {
+            XCTAssertEqual(error.errorCode, SwiftyJSONError.wrongType.rawValue)
+            XCTAssertEqual(type(of: error).errorDomain, SwiftyJSONError.errorDomain)
+            XCTAssertEqual(error.errorUserInfo as! [String: String], [NSLocalizedDescriptionKey: "Couldn't merge, because the JSONs differ in type on top level."])
+        } catch _ {}
+    }
+
+    func testPrimitiveType() {
+        let A = JSON("a")
+        let B = JSON("b")
+        XCTAssertEqual(try! A.merged(with: B), B)
+    }
+
+    func testMergeEqual() {
+        let json = JSON(["a": "A"])
+        XCTAssertEqual(try! json.merged(with: json), json)
+    }
+
+    func testMergeUnequalValues() {
+        let A = JSON(["a": "A"])
+        let B = JSON(["a": "B"])
+        XCTAssertEqual(try! A.merged(with: B), B)
+    }
+
+    func testMergeUnequalKeysAndValues() {
+        let A = JSON(["a": "A"])
+        let B = JSON(["b": "B"])
+        XCTAssertEqual(try! A.merged(with: B), JSON(["a": "A", "b": "B"]))
+    }
+
+    func testMergeFilledAndEmpty() {
+        let A = JSON(["a": "A"])
+        let B = JSON([:])
+        XCTAssertEqual(try! A.merged(with: B), A)
+    }
+
+    func testMergeEmptyAndFilled() {
+        let A = JSON([:])
+        let B = JSON(["a": "A"])
+        XCTAssertEqual(try! A.merged(with: B), B)
+    }
+
+    func testMergeArray() {
+        let A = JSON(["a"])
+        let B = JSON(["b"])
+        XCTAssertEqual(try! A.merged(with: B), JSON(["a", "b"]))
+    }
+
+    func testMergeNestedJSONs() {
+        let A = JSON([
+            "nested": [
+                "A": "a"
+            ]
+        ])
+
+        let B = JSON([
+            "nested": [
+                "A": "b"
+            ]
+        ])
+
+        XCTAssertEqual(try! A.merged(with: B), B)
+    }
+}
@@ -0,0 +1,148 @@
+//  MutabilityTests.swift
+//
+//  Copyright (c) 2014 - 2017 Zigii Wong
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class MutabilityTests: XCTestCase {
+
+    func testDictionaryMutability() {
+        let dictionary: [String: Any] = [
+            "string": "STRING",
+            "number": 9823.212,
+            "bool": true,
+            "empty": ["nothing"],
+            "foo": ["bar": ["1"]],
+            "bar": ["foo": ["1": "a"]]
+        ]
+
+        var json = JSON(dictionary)
+        XCTAssertEqual(json["string"], "STRING")
+        XCTAssertEqual(json["number"], 9823.212)
+        XCTAssertEqual(json["bool"], true)
+        XCTAssertEqual(json["empty"], ["nothing"])
+
+        json["string"] = "muted"
+        XCTAssertEqual(json["string"], "muted")
+
+        json["number"] = 9999.0
+        XCTAssertEqual(json["number"], 9999.0)
+
+        json["bool"] = false
+        XCTAssertEqual(json["bool"], false)
+
+        json["empty"] = []
+        XCTAssertEqual(json["empty"], [])
+
+        json["new"] = JSON(["foo": "bar"])
+        XCTAssertEqual(json["new"], ["foo": "bar"])
+
+        json["foo"]["bar"] = JSON([])
+        XCTAssertEqual(json["foo"]["bar"], [])
+
+        json["bar"]["foo"] = JSON(["2": "b"])
+        XCTAssertEqual(json["bar"]["foo"], ["2": "b"])
+    }
+
+    func testArrayMutability() {
+        let array: [Any] = ["1", "2", 3, true, []]
+
+        var json = JSON(array)
+        XCTAssertEqual(json[0], "1")
+        XCTAssertEqual(json[1], "2")
+        XCTAssertEqual(json[2], 3)
+        XCTAssertEqual(json[3], true)
+        XCTAssertEqual(json[4], [])
+
+        json[0] = false
+        XCTAssertEqual(json[0], false)
+
+        json[1] = 2
+        XCTAssertEqual(json[1], 2)
+
+        json[2] = "3"
+        XCTAssertEqual(json[2], "3")
+
+        json[3] = [:]
+        XCTAssertEqual(json[3], [:])
+
+        json[4] = [1, 2]
+        XCTAssertEqual(json[4], [1, 2])
+    }
+
+    func testValueMutability() {
+        var intArray = JSON([0, 1, 2])
+        intArray[0] = JSON(55)
+        XCTAssertEqual(intArray[0], 55)
+        XCTAssertEqual(intArray[0].intValue, 55)
+
+        var dictionary = JSON(["foo": "bar"])
+        dictionary["foo"] = JSON("foo")
+        XCTAssertEqual(dictionary["foo"], "foo")
+        XCTAssertEqual(dictionary["foo"].stringValue, "foo")
+
+        var number = JSON(1)
+        number = JSON("111")
+        XCTAssertEqual(number, "111")
+        XCTAssertEqual(number.intValue, 111)
+        XCTAssertEqual(number.stringValue, "111")
+
+        var boolean = JSON(true)
+        boolean = JSON(false)
+        XCTAssertEqual(boolean, false)
+        XCTAssertEqual(boolean.boolValue, false)
+    }
+
+    func testArrayRemovability() {
+        let array = ["Test", "Test2", "Test3"]
+        var json = JSON(array)
+
+        json.arrayObject?.removeFirst()
+        XCTAssertEqual(false, json.arrayValue.isEmpty)
+        XCTAssertEqual(json.arrayValue, ["Test2", "Test3"])
+
+        json.arrayObject?.removeLast()
+        XCTAssertEqual(false, json.arrayValue.isEmpty)
+        XCTAssertEqual(json.arrayValue, ["Test2"])
+
+        json.arrayObject?.removeAll()
+        XCTAssertEqual(true, json.arrayValue.isEmpty)
+        XCTAssertEqual(JSON([]), json)
+    }
+
+    func testDictionaryRemovability() {
+        let dictionary: [String: Any] = ["key1": "Value1", "key2": 2, "key3": true]
+        var json = JSON(dictionary)
+
+        json.dictionaryObject?.removeValue(forKey: "key1")
+        XCTAssertEqual(false, json.dictionaryValue.isEmpty)
+        XCTAssertEqual(json.dictionaryValue, ["key2": 2, "key3": true])
+
+        json.dictionaryObject?.removeValue(forKey: "key3")
+        XCTAssertEqual(false, json.dictionaryValue.isEmpty)
+        XCTAssertEqual(json.dictionaryValue, ["key2": 2])
+
+        json.dictionaryObject?.removeAll()
+        XCTAssertEqual(true, json.dictionaryValue.isEmpty)
+        XCTAssertEqual(json.dictionaryValue, [:])
+    }
+}
@@ -0,0 +1,88 @@
+//  NestedJSONTests.swift
+//
+//  Created by Hector Matos on 9/27/16.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class NestedJSONTests: XCTestCase {
+    let family: JSON = [
+        "names": [
+            "Brooke Abigail Matos",
+            "Rowan Danger Matos"
+        ],
+        "motto": "Hey, I don't know about you, but I'm feeling twenty-two! So, release the KrakenDev!"
+    ]
+
+    func testTopLevelNestedJSON() {
+        let nestedJSON: JSON = [
+            "family": family
+        ]
+        XCTAssertNotNil(try? nestedJSON.rawData())
+    }
+
+    func testDeeplyNestedJSON() {
+        let nestedFamily: JSON = [
+            "count": 1,
+            "families": [
+                [
+                    "isACoolFamily": true,
+                    "family": [
+                        "hello": family
+                    ]
+                ]
+            ]
+        ]
+        XCTAssertNotNil(try? nestedFamily.rawData())
+    }
+
+    func testArrayJSON() {
+        let arr: [JSON] = ["a", 1, ["b", 2]]
+        let json = JSON(arr)
+        XCTAssertEqual(json[0].string, "a")
+        XCTAssertEqual(json[2, 1].int, 2)
+    }
+
+    func testDictionaryJSON() {
+        let json: JSON = ["a": JSON("1"), "b": JSON([1, 2, "3"]), "c": JSON(["aa": "11", "bb": 22])]
+        XCTAssertEqual(json["a"].string, "1")
+        XCTAssertEqual(json["b"].array!, [1, 2, "3"])
+        XCTAssertEqual(json["c"]["aa"].string, "11")
+    }
+
+    func testNestedJSON() {
+        let inner = JSON([
+            "some_field": "1" + "2"
+            ])
+        let json = JSON([
+            "outer_field": "1" + "2",
+            "inner_json": inner
+            ])
+        XCTAssertEqual(json["inner_json"], ["some_field": "12"])
+
+        let foo = "foo"
+        let json2 = JSON([
+            "outer_field": foo,
+            "inner_json": inner
+            ])
+        XCTAssertEqual(json2["inner_json"].rawValue as! [String: String], ["some_field": "12"])
+    }
+}
@@ -0,0 +1,387 @@
+//  NumberTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class NumberTests: XCTestCase {
+
+    func testNumber() {
+        //getter
+        var json = JSON(NSNumber(value: 9876543210.123456789))
+        XCTAssertEqual(json.number!, 9876543210.123456789)
+        XCTAssertEqual(json.numberValue, 9876543210.123456789)
+        XCTAssertEqual(json.stringValue, "9876543210.123457")
+
+        json.string = "1000000000000000000000000000.1"
+        XCTAssertNil(json.number)
+        XCTAssertEqual(json.numberValue.description, "1000000000000000000000000000.1")
+
+        json.string = "1e+27"
+        XCTAssertEqual(json.numberValue.description, "1000000000000000000000000000")
+
+        //setter
+        json.number = NSNumber(value: 123456789.0987654321)
+        XCTAssertEqual(json.number!, 123456789.0987654321)
+        XCTAssertEqual(json.numberValue, 123456789.0987654321)
+
+        json.number = nil
+        XCTAssertEqual(json.numberValue, 0)
+        XCTAssertEqual(json.object as? NSNull, NSNull())
+        XCTAssertTrue(json.number == nil)
+
+        json.numberValue = 2.9876
+        XCTAssertEqual(json.number!, 2.9876)
+    }
+
+    func testBool() {
+        var json = JSON(true)
+        XCTAssertEqual(json.bool!, true)
+        XCTAssertEqual(json.boolValue, true)
+        XCTAssertEqual(json.numberValue, true as NSNumber)
+        XCTAssertEqual(json.stringValue, "true")
+
+        json.bool = false
+        XCTAssertEqual(json.bool!, false)
+        XCTAssertEqual(json.boolValue, false)
+        XCTAssertEqual(json.numberValue, false as NSNumber)
+
+        json.bool = nil
+        XCTAssertTrue(json.bool == nil)
+        XCTAssertEqual(json.boolValue, false)
+        XCTAssertEqual(json.numberValue, 0)
+
+        json.boolValue = true
+        XCTAssertEqual(json.bool!, true)
+        XCTAssertEqual(json.boolValue, true)
+        XCTAssertEqual(json.numberValue, true as NSNumber)
+    }
+
+    func testDouble() {
+        var json = JSON(9876543210.123456789)
+        XCTAssertEqual(json.double!, 9876543210.123456789)
+        XCTAssertEqual(json.doubleValue, 9876543210.123456789)
+        XCTAssertEqual(json.numberValue, 9876543210.123456789)
+        XCTAssertEqual(json.stringValue, "9876543210.123457")
+
+        json.double = 2.8765432
+        XCTAssertEqual(json.double!, 2.8765432)
+        XCTAssertEqual(json.doubleValue, 2.8765432)
+        XCTAssertEqual(json.numberValue, 2.8765432)
+
+        json.doubleValue = 89.0987654
+        XCTAssertEqual(json.double!, 89.0987654)
+        XCTAssertEqual(json.doubleValue, 89.0987654)
+        XCTAssertEqual(json.numberValue, 89.0987654)
+
+        json.double = nil
+        XCTAssertEqual(json.boolValue, false)
+        XCTAssertEqual(json.doubleValue, 0.0)
+        XCTAssertEqual(json.numberValue, 0)
+    }
+
+    func testFloat() {
+        var json = JSON(54321.12345)
+        XCTAssertTrue(json.float! == 54321.12345)
+        XCTAssertTrue(json.floatValue == 54321.12345)
+        XCTAssertEqual(json.numberValue, 54321.12345)
+        XCTAssertEqual(json.stringValue, "54321.12345")
+
+        json.double = 23231.65
+        XCTAssertTrue(json.float! == 23231.65)
+        XCTAssertTrue(json.floatValue == 23231.65)
+        XCTAssertEqual(json.numberValue, NSNumber(value: 23231.65))
+
+        json.double = -98766.23
+        XCTAssertEqual(json.float!, -98766.23)
+        XCTAssertEqual(json.floatValue, -98766.23)
+        XCTAssertEqual(json.numberValue, NSNumber(value: -98766.23))
+    }
+
+    func testInt() {
+        var json = JSON(123456789)
+        XCTAssertEqual(json.int!, 123456789)
+        XCTAssertEqual(json.intValue, 123456789)
+        XCTAssertEqual(json.numberValue, NSNumber(value: 123456789))
+        XCTAssertEqual(json.stringValue, "123456789")
+
+        json.int = nil
+        XCTAssertTrue(json.boolValue == false)
+        XCTAssertTrue(json.intValue == 0)
+        XCTAssertEqual(json.numberValue, 0)
+        XCTAssertEqual(json.object as? NSNull, NSNull())
+        XCTAssertTrue(json.int == nil)
+
+        json.intValue = 76543
+        XCTAssertEqual(json.int!, 76543)
+        XCTAssertEqual(json.intValue, 76543)
+        XCTAssertEqual(json.numberValue, NSNumber(value: 76543))
+
+        json.intValue = 98765421
+        XCTAssertEqual(json.int!, 98765421)
+        XCTAssertEqual(json.intValue, 98765421)
+        XCTAssertEqual(json.numberValue, NSNumber(value: 98765421))
+    }
+
+    func testUInt() {
+        var json = JSON(123456789)
+        XCTAssertTrue(json.uInt! == 123456789)
+        XCTAssertTrue(json.uIntValue == 123456789)
+        XCTAssertEqual(json.numberValue, NSNumber(value: 123456789))
+        XCTAssertEqual(json.stringValue, "123456789")
+
+        json.uInt = nil
+        XCTAssertTrue(json.boolValue == false)
+        XCTAssertTrue(json.uIntValue == 0)
+        XCTAssertEqual(json.numberValue, 0)
+        XCTAssertEqual(json.object as? NSNull, NSNull())
+        XCTAssertTrue(json.uInt == nil)
+
+        json.uIntValue = 76543
+        XCTAssertTrue(json.uInt! == 76543)
+        XCTAssertTrue(json.uIntValue == 76543)
+        XCTAssertEqual(json.numberValue, NSNumber(value: 76543))
+
+        json.uIntValue = 98765421
+        XCTAssertTrue(json.uInt! == 98765421)
+        XCTAssertTrue(json.uIntValue == 98765421)
+        XCTAssertEqual(json.numberValue, NSNumber(value: 98765421))
+    }
+
+    func testInt8() {
+        let n127 = NSNumber(value: 127)
+        var json = JSON(n127)
+        XCTAssertTrue(json.int8! == n127.int8Value)
+        XCTAssertTrue(json.int8Value == n127.int8Value)
+        XCTAssertTrue(json.number! == n127)
+        XCTAssertEqual(json.numberValue, n127)
+        XCTAssertEqual(json.stringValue, "127")
+
+        let nm128 = NSNumber(value: -128)
+        json.int8Value = nm128.int8Value
+        XCTAssertTrue(json.int8! == nm128.int8Value)
+        XCTAssertTrue(json.int8Value == nm128.int8Value)
+        XCTAssertTrue(json.number! == nm128)
+        XCTAssertEqual(json.numberValue, nm128)
+        XCTAssertEqual(json.stringValue, "-128")
+
+        let n0 = NSNumber(value: 0 as Int8)
+        json.int8Value = n0.int8Value
+        XCTAssertTrue(json.int8! == n0.int8Value)
+        XCTAssertTrue(json.int8Value == n0.int8Value)
+        XCTAssertTrue(json.number! == n0)
+        XCTAssertEqual(json.numberValue, n0)
+        XCTAssertEqual(json.stringValue, "0")
+
+        let n1 = NSNumber(value: 1 as Int8)
+        json.int8Value = n1.int8Value
+        XCTAssertTrue(json.int8! == n1.int8Value)
+        XCTAssertTrue(json.int8Value == n1.int8Value)
+        XCTAssertTrue(json.number! == n1)
+        XCTAssertEqual(json.numberValue, n1)
+        XCTAssertEqual(json.stringValue, "1")
+    }
+
+    func testUInt8() {
+        let n255 = NSNumber(value: 255)
+        var json = JSON(n255)
+        XCTAssertTrue(json.uInt8! == n255.uint8Value)
+        XCTAssertTrue(json.uInt8Value == n255.uint8Value)
+        XCTAssertTrue(json.number! == n255)
+        XCTAssertEqual(json.numberValue, n255)
+        XCTAssertEqual(json.stringValue, "255")
+
+        let nm2 = NSNumber(value: 2)
+        json.uInt8Value = nm2.uint8Value
+        XCTAssertTrue(json.uInt8! == nm2.uint8Value)
+        XCTAssertTrue(json.uInt8Value == nm2.uint8Value)
+        XCTAssertTrue(json.number! == nm2)
+        XCTAssertEqual(json.numberValue, nm2)
+        XCTAssertEqual(json.stringValue, "2")
+
+        let nm0 = NSNumber(value: 0)
+        json.uInt8Value = nm0.uint8Value
+        XCTAssertTrue(json.uInt8! == nm0.uint8Value)
+        XCTAssertTrue(json.uInt8Value == nm0.uint8Value)
+        XCTAssertTrue(json.number! == nm0)
+        XCTAssertEqual(json.numberValue, nm0)
+        XCTAssertEqual(json.stringValue, "0")
+
+        let nm1 = NSNumber(value: 1)
+        json.uInt8 = nm1.uint8Value
+        XCTAssertTrue(json.uInt8! == nm1.uint8Value)
+        XCTAssertTrue(json.uInt8Value == nm1.uint8Value)
+        XCTAssertTrue(json.number! == nm1)
+        XCTAssertEqual(json.numberValue, nm1)
+        XCTAssertEqual(json.stringValue, "1")
+    }
+
+    func testInt16() {
+
+        let n32767 = NSNumber(value: 32767)
+        var json = JSON(n32767)
+        XCTAssertTrue(json.int16! == n32767.int16Value)
+        XCTAssertTrue(json.int16Value == n32767.int16Value)
+        XCTAssertTrue(json.number! == n32767)
+        XCTAssertEqual(json.numberValue, n32767)
+        XCTAssertEqual(json.stringValue, "32767")
+
+        let nm32768 = NSNumber(value: -32768)
+        json.int16Value = nm32768.int16Value
+        XCTAssertTrue(json.int16! == nm32768.int16Value)
+        XCTAssertTrue(json.int16Value == nm32768.int16Value)
+        XCTAssertTrue(json.number! == nm32768)
+        XCTAssertEqual(json.numberValue, nm32768)
+        XCTAssertEqual(json.stringValue, "-32768")
+
+        let n0 = NSNumber(value: 0)
+        json.int16Value = n0.int16Value
+        XCTAssertTrue(json.int16! == n0.int16Value)
+        XCTAssertTrue(json.int16Value == n0.int16Value)
+        XCTAssertEqual(json.number, n0)
+        XCTAssertEqual(json.numberValue, n0)
+        XCTAssertEqual(json.stringValue, "0")
+
+        let n1 = NSNumber(value: 1)
+        json.int16 = n1.int16Value
+        XCTAssertTrue(json.int16! == n1.int16Value)
+        XCTAssertTrue(json.int16Value == n1.int16Value)
+        XCTAssertTrue(json.number! == n1)
+        XCTAssertEqual(json.numberValue, n1)
+        XCTAssertEqual(json.stringValue, "1")
+    }
+
+    func testUInt16() {
+
+        let n65535 = NSNumber(value: 65535)
+        var json = JSON(n65535)
+        XCTAssertTrue(json.uInt16! == n65535.uint16Value)
+        XCTAssertTrue(json.uInt16Value == n65535.uint16Value)
+        XCTAssertTrue(json.number! == n65535)
+        XCTAssertEqual(json.numberValue, n65535)
+        XCTAssertEqual(json.stringValue, "65535")
+
+        let n32767 = NSNumber(value: 32767)
+        json.uInt16 = n32767.uint16Value
+        XCTAssertTrue(json.uInt16! == n32767.uint16Value)
+        XCTAssertTrue(json.uInt16Value == n32767.uint16Value)
+        XCTAssertTrue(json.number! == n32767)
+        XCTAssertEqual(json.numberValue, n32767)
+        XCTAssertEqual(json.stringValue, "32767")
+    }
+
+    func testInt32() {
+        let n2147483647 = NSNumber(value: 2147483647)
+        var json = JSON(n2147483647)
+        XCTAssertTrue(json.int32! == n2147483647.int32Value)
+        XCTAssertTrue(json.int32Value == n2147483647.int32Value)
+        XCTAssertTrue(json.number! == n2147483647)
+        XCTAssertEqual(json.numberValue, n2147483647)
+        XCTAssertEqual(json.stringValue, "2147483647")
+
+        let n32767 = NSNumber(value: 32767)
+        json.int32 = n32767.int32Value
+        XCTAssertTrue(json.int32! == n32767.int32Value)
+        XCTAssertTrue(json.int32Value == n32767.int32Value)
+        XCTAssertTrue(json.number! == n32767)
+        XCTAssertEqual(json.numberValue, n32767)
+        XCTAssertEqual(json.stringValue, "32767")
+
+        let nm2147483648 = NSNumber(value: -2147483648)
+        json.int32Value = nm2147483648.int32Value
+        XCTAssertTrue(json.int32! == nm2147483648.int32Value)
+        XCTAssertTrue(json.int32Value == nm2147483648.int32Value)
+        XCTAssertTrue(json.number! == nm2147483648)
+        XCTAssertEqual(json.numberValue, nm2147483648)
+        XCTAssertEqual(json.stringValue, "-2147483648")
+    }
+
+    func testUInt32() {
+        let n2147483648 = NSNumber(value: 2147483648 as UInt32)
+        var json = JSON(n2147483648)
+        XCTAssertTrue(json.uInt32! == n2147483648.uint32Value)
+        XCTAssertTrue(json.uInt32Value == n2147483648.uint32Value)
+        XCTAssertTrue(json.number! == n2147483648)
+        XCTAssertEqual(json.numberValue, n2147483648)
+        XCTAssertEqual(json.stringValue, "2147483648")
+
+        let n32767 = NSNumber(value: 32767 as UInt32)
+        json.uInt32 = n32767.uint32Value
+        XCTAssertTrue(json.uInt32! == n32767.uint32Value)
+        XCTAssertTrue(json.uInt32Value == n32767.uint32Value)
+        XCTAssertTrue(json.number! == n32767)
+        XCTAssertEqual(json.numberValue, n32767)
+        XCTAssertEqual(json.stringValue, "32767")
+
+        let n0 = NSNumber(value: 0 as UInt32)
+        json.uInt32Value = n0.uint32Value
+        XCTAssertTrue(json.uInt32! == n0.uint32Value)
+        XCTAssertTrue(json.uInt32Value == n0.uint32Value)
+        XCTAssertTrue(json.number! == n0)
+        XCTAssertEqual(json.numberValue, n0)
+        XCTAssertEqual(json.stringValue, "0")
+    }
+
+    func testInt64() {
+        let int64Max = NSNumber(value: INT64_MAX)
+        var json = JSON(int64Max)
+        XCTAssertTrue(json.int64! == int64Max.int64Value)
+        XCTAssertTrue(json.int64Value == int64Max.int64Value)
+        XCTAssertTrue(json.number! == int64Max)
+        XCTAssertEqual(json.numberValue, int64Max)
+        XCTAssertEqual(json.stringValue, int64Max.stringValue)
+
+        let n32767 = NSNumber(value: 32767)
+        json.int64 = n32767.int64Value
+        XCTAssertTrue(json.int64! == n32767.int64Value)
+        XCTAssertTrue(json.int64Value == n32767.int64Value)
+        XCTAssertTrue(json.number! == n32767)
+        XCTAssertEqual(json.numberValue, n32767)
+        XCTAssertEqual(json.stringValue, "32767")
+
+        let int64Min = NSNumber(value: (INT64_MAX-1) * -1)
+        json.int64Value = int64Min.int64Value
+        XCTAssertTrue(json.int64! == int64Min.int64Value)
+        XCTAssertTrue(json.int64Value == int64Min.int64Value)
+        XCTAssertTrue(json.number! == int64Min)
+        XCTAssertEqual(json.numberValue, int64Min)
+        XCTAssertEqual(json.stringValue, int64Min.stringValue)
+    }
+
+    func testUInt64() {
+        let uInt64Max = NSNumber(value: UINT64_MAX)
+        var json = JSON(uInt64Max)
+        XCTAssertTrue(json.uInt64! == uInt64Max.uint64Value)
+        XCTAssertTrue(json.uInt64Value == uInt64Max.uint64Value)
+        XCTAssertTrue(json.number! == uInt64Max)
+        XCTAssertEqual(json.numberValue, uInt64Max)
+        XCTAssertEqual(json.stringValue, uInt64Max.stringValue)
+
+        let n32767 = NSNumber(value: 32767)
+        json.int64 = n32767.int64Value
+        XCTAssertTrue(json.int64! == n32767.int64Value)
+        XCTAssertTrue(json.int64Value == n32767.int64Value)
+        XCTAssertTrue(json.number! == n32767)
+        XCTAssertEqual(json.numberValue, n32767)
+        XCTAssertEqual(json.stringValue, "32767")
+    }
+}
@@ -0,0 +1,137 @@
+//  PerformanceTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class PerformanceTests: XCTestCase {
+
+    var testData: Data!
+
+    override func setUp() {
+        super.setUp()
+
+        if let file = Bundle(for: PerformanceTests.self).path(forResource: "Tests", ofType: "json") {
+            self.testData = try? Data(contentsOf: URL(fileURLWithPath: file))
+        } else {
+            XCTFail("Can't find the test JSON file")
+        }
+    }
+
+    override func tearDown() {
+        // Put teardown code here. This method is called after the invocation of each test method in the class.
+        super.tearDown()
+    }
+
+    func testInitPerformance() {
+        self.measure {
+            for _ in 1...100 {
+                guard let json = try? JSON(data: self.testData) else {
+                    XCTFail("Unable to parse testData")
+                    return
+                }
+                XCTAssertTrue(json != JSON.null)
+            }
+        }
+    }
+
+    func testObjectMethodPerformance() {
+        guard let json = try? JSON(data: self.testData) else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+        self.measure {
+            for _ in 1...100 {
+                let object: Any? = json.object
+                XCTAssertTrue(object != nil)
+            }
+        }
+    }
+
+    func testArrayMethodPerformance() {
+        guard let json = try? JSON(data: self.testData) else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+        self.measure {
+            for _ in 1...100 {
+                autoreleasepool {
+                    if let array = json.array {
+                        XCTAssertTrue(array.count > 0)
+                    }
+                }
+            }
+        }
+    }
+
+    func testDictionaryMethodPerformance() {
+        guard let json = try? JSON(data: self.testData)[0] else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+        self.measure {
+            for _ in 1...100 {
+                autoreleasepool {
+                    if let dictionary = json.dictionary {
+                        XCTAssertTrue(dictionary.count > 0)
+                    }
+                }
+            }
+        }
+    }
+
+    func testRawStringMethodPerformance() {
+        guard let json = try? JSON(data: self.testData) else {
+            XCTFail("Unable to parse testData")
+            return
+        }
+        self.measure {
+            for _ in 1...100 {
+                autoreleasepool {
+                    let string = json.rawString()
+                    XCTAssertTrue(string != nil)
+                }
+            }
+        }
+    }
+
+    func testLargeDictionaryMethodPerformance() {
+        var data: [String: JSON] = [:]
+        (0...100000).forEach { n in
+            data["\(n)"] = JSON([
+                "name": "item\(n)",
+                "id": n
+                ])
+        }
+        let json = JSON(data)
+
+        self.measure {
+            autoreleasepool {
+                if let dictionary = json.dictionary {
+                    XCTAssertTrue(dictionary.count == 100001)
+                } else {
+                    XCTFail("dictionary should not be nil")
+                }
+            }
+        }
+    }
+}
@@ -0,0 +1,124 @@
+//  PrintableTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class PrintableTests: XCTestCase {
+    func testNumber() {
+        let json: JSON = 1234567890.876623
+        XCTAssertEqual(json.description, "1234567890.876623")
+        XCTAssertEqual(json.debugDescription, "1234567890.876623")
+    }
+
+    func testBool() {
+        let jsonTrue: JSON = true
+        XCTAssertEqual(jsonTrue.description, "true")
+        XCTAssertEqual(jsonTrue.debugDescription, "true")
+        let jsonFalse: JSON = false
+        XCTAssertEqual(jsonFalse.description, "false")
+        XCTAssertEqual(jsonFalse.debugDescription, "false")
+    }
+
+    func testString() {
+        let json: JSON = "abcd efg, HIJK;LMn"
+        XCTAssertEqual(json.description, "abcd efg, HIJK;LMn")
+        XCTAssertEqual(json.debugDescription, "abcd efg, HIJK;LMn")
+    }
+
+    func testNil() {
+        let jsonNil_1: JSON = JSON.null
+        XCTAssertEqual(jsonNil_1.description, "null")
+        XCTAssertEqual(jsonNil_1.debugDescription, "null")
+        let jsonNil_2: JSON = JSON(NSNull())
+        XCTAssertEqual(jsonNil_2.description, "null")
+        XCTAssertEqual(jsonNil_2.debugDescription, "null")
+    }
+
+    func testArray() {
+        let json: JSON = [1, 2, "4", 5, "6"]
+        var description = json.description.replacingOccurrences(of: "\n", with: "")
+        description = description.replacingOccurrences(of: " ", with: "")
+        XCTAssertEqual(description, "[1,2,\"4\",5,\"6\"]")
+        XCTAssertTrue(json.description.lengthOfBytes(using: String.Encoding.utf8) > 0)
+        XCTAssertTrue(json.debugDescription.lengthOfBytes(using: String.Encoding.utf8) > 0)
+    }
+
+    func testArrayWithStrings() {
+        let array = ["\"123\""]
+        let json = JSON(array)
+        var description = json.description.replacingOccurrences(of: "\n", with: "")
+        description = description.replacingOccurrences(of: " ", with: "")
+        XCTAssertEqual(description, "[\"\\\"123\\\"\"]")
+        XCTAssertTrue(json.description.lengthOfBytes(using: String.Encoding.utf8) > 0)
+        XCTAssertTrue(json.debugDescription.lengthOfBytes(using: String.Encoding.utf8) > 0)
+    }
+
+    func testArrayWithOptionals() {
+        let array = [1, 2, "4", 5, "6", nil] as [Any?]
+        let json = JSON(array)
+		guard var description = json.rawString([.castNilToNSNull: true]) else {
+			XCTFail("could not represent array")
+			return
+		}
+		description = description.replacingOccurrences(of: "\n", with: "")
+        description = description.replacingOccurrences(of: " ", with: "")
+        XCTAssertEqual(description, "[1,2,\"4\",5,\"6\",null]")
+        XCTAssertTrue(json.description.lengthOfBytes(using: String.Encoding.utf8) > 0)
+        XCTAssertTrue(json.debugDescription.lengthOfBytes(using: String.Encoding.utf8) > 0)
+    }
+
+    func testDictionary() {
+        let json: JSON = ["1": 2, "2": "two", "3": 3]
+        var debugDescription = json.debugDescription.replacingOccurrences(of: "\n", with: "")
+        debugDescription = debugDescription.replacingOccurrences(of: " ", with: "")
+        XCTAssertTrue(json.description.lengthOfBytes(using: String.Encoding.utf8) > 0)
+        XCTAssertTrue(debugDescription.range(of: "\"1\":2", options: String.CompareOptions.caseInsensitive) != nil)
+        XCTAssertTrue(debugDescription.range(of: "\"2\":\"two\"", options: String.CompareOptions.caseInsensitive) != nil)
+        XCTAssertTrue(debugDescription.range(of: "\"3\":3", options: String.CompareOptions.caseInsensitive) != nil)
+    }
+
+    func testDictionaryWithStrings() {
+        let dict = ["foo": "{\"bar\":123}"] as [String: Any]
+        let json = JSON(dict)
+        var debugDescription = json.debugDescription.replacingOccurrences(of: "\n", with: "")
+        debugDescription = debugDescription.replacingOccurrences(of: " ", with: "")
+        XCTAssertTrue(json.description.lengthOfBytes(using: String.Encoding.utf8) > 0)
+        let exceptedResult = "{\"foo\":\"{\\\"bar\\\":123}\"}"
+        XCTAssertEqual(debugDescription, exceptedResult)
+    }
+
+    func testDictionaryWithOptionals() {
+        let dict = ["1": 2, "2": "two", "3": nil] as [String: Any?]
+        let json = JSON(dict)
+		guard var description = json.rawString([.castNilToNSNull: true]) else {
+			XCTFail("could not represent dictionary")
+			return
+		}
+		description = description.replacingOccurrences(of: "\n", with: "")
+        description = description.replacingOccurrences(of: " ", with: "")
+        XCTAssertTrue(json.description.lengthOfBytes(using: String.Encoding.utf8) > 0)
+        XCTAssertTrue(description.range(of: "\"1\":2", options: NSString.CompareOptions.caseInsensitive) != nil)
+        XCTAssertTrue(description.range(of: "\"2\":\"two\"", options: NSString.CompareOptions.caseInsensitive) != nil)
+        XCTAssertTrue(description.range(of: "\"3\":null", options: NSString.CompareOptions.caseInsensitive) != nil)
+    }
+}
@@ -0,0 +1,108 @@
+//  RawRepresentableTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class RawRepresentableTests: XCTestCase {
+
+    func testNumber() {
+        var json: JSON = JSON(rawValue: 948394394.347384 as NSNumber)!
+        XCTAssertEqual(json.int!, 948394394)
+        XCTAssertEqual(json.intValue, 948394394)
+        XCTAssertEqual(json.double!, 948394394.347384)
+        XCTAssertEqual(json.doubleValue, 948394394.347384)
+        XCTAssertEqual(json.float!, 948394394.347384)
+        XCTAssertEqual(json.floatValue, 948394394.347384)
+
+        let object: Any = json.rawValue
+        if let int = object as? Int {
+            XCTAssertEqual(int, 948394394)
+        }
+        XCTAssertEqual(object as? Double, 948394394.347384)
+        if let float = object as? Float {
+            XCTAssertEqual(float, 948394394.347384)
+        }
+        XCTAssertEqual(object as? NSNumber, 948394394.347384)
+    }
+
+    func testBool() {
+        var jsonTrue: JSON = JSON(rawValue: true as NSNumber)!
+        XCTAssertEqual(jsonTrue.bool!, true)
+        XCTAssertEqual(jsonTrue.boolValue, true)
+
+        var jsonFalse: JSON = JSON(rawValue: false)!
+        XCTAssertEqual(jsonFalse.bool!, false)
+        XCTAssertEqual(jsonFalse.boolValue, false)
+
+        let objectTrue = jsonTrue.rawValue
+        XCTAssertEqual(objectTrue as? Bool, true)
+
+        let objectFalse = jsonFalse.rawValue
+        XCTAssertEqual(objectFalse as? Bool, false)
+    }
+
+    func testString() {
+        let string = "The better way to deal with JSON data in Swift."
+        if let json: JSON = JSON(rawValue: string) {
+            XCTAssertEqual(json.string!, string)
+            XCTAssertEqual(json.stringValue, string)
+            XCTAssertTrue(json.array == nil)
+            XCTAssertTrue(json.dictionary == nil)
+            XCTAssertTrue(json.null == nil)
+            XCTAssertTrue(json.error == nil)
+            XCTAssertTrue(json.type == .string)
+            XCTAssertEqual(json.object as? String, string)
+        } else {
+            XCTFail("Should not run into here")
+        }
+
+        let object: Any = JSON(rawValue: string)!.rawValue
+        XCTAssertEqual(object as? String, string)
+    }
+
+    func testNil() {
+        if JSON(rawValue: NSObject()) != nil {
+            XCTFail("Should not run into here")
+        }
+    }
+
+    func testArray() {
+        let array = [1, 2, "3", 4102, "5632", "abocde", "!@# $%^&*()"] as NSArray
+        if let json: JSON = JSON(rawValue: array) {
+            XCTAssertEqual(json, JSON(array))
+        }
+
+        let object: Any = JSON(rawValue: array)!.rawValue
+        XCTAssertTrue(array == object as! NSArray)
+    }
+
+    func testDictionary() {
+        let dictionary = ["1": 2, "2": 2, "three": 3, "list": ["aa", "bb", "dd"]] as NSDictionary
+        if let json: JSON = JSON(rawValue: dictionary) {
+            XCTAssertEqual(json, JSON(dictionary))
+        }
+
+        let object: Any = JSON(rawValue: dictionary)!.rawValue
+        XCTAssertTrue(dictionary == object as! NSDictionary)
+    }
+}
@@ -0,0 +1,105 @@
+//  RawTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class RawTests: XCTestCase {
+
+    func testRawData() {
+        let json: JSON = ["somekey": "some string value"]
+        let expectedRawData = "{\"somekey\":\"some string value\"}".data(using: String.Encoding.utf8)
+        do {
+            let data: Data = try json.rawData()
+            XCTAssertEqual(expectedRawData, data)
+        } catch _ {}
+    }
+
+    func testInvalidJSONForRawData() {
+        let json: JSON = "...<nonsense>xyz</nonsense>"
+        do {
+            _ = try json.rawData()
+        } catch let error as SwiftyJSONError {
+            XCTAssertEqual(error, SwiftyJSONError.invalidJSON)
+        } catch _ {}
+    }
+
+    func testArray() {
+        let json: JSON = [1, "2", 3.12, NSNull(), true, ["name": "Jack"]]
+        let data: Data?
+        do {
+            data = try json.rawData()
+        } catch _ {
+            data = nil
+        }
+        let string = json.rawString()
+        XCTAssertTrue (data != nil)
+        XCTAssertTrue (string!.lengthOfBytes(using: String.Encoding.utf8) > 0)
+    }
+
+    func testDictionary() {
+        let json: JSON = ["number": 111111.23456789, "name": "Jack", "list": [1, 2, 3, 4], "bool": false, "null": NSNull()]
+        let data: Data?
+        do {
+            data = try json.rawData()
+        } catch _ {
+            data = nil
+        }
+        let string = json.rawString()
+        XCTAssertTrue (data != nil)
+        XCTAssertTrue (string!.lengthOfBytes(using: String.Encoding.utf8) > 0)
+    }
+
+    func testString() {
+        let json: JSON = "I'm a json"
+        XCTAssertEqual(json.rawString(), "I'm a json")
+    }
+
+    func testNumber() {
+        let json: JSON = 123456789.123
+        XCTAssertEqual(json.rawString(), "123456789.123")
+    }
+
+    func testBool() {
+        let json: JSON = true
+        XCTAssertEqual(json.rawString(), "true")
+    }
+
+    func testNull() {
+        let json: JSON = JSON.null
+        XCTAssertEqual(json.rawString(), "null")
+    }
+
+    func testNestedJSON() {
+        let inner: JSON = ["name": "john doe"]
+        let json: JSON = ["level": 1337, "user": inner]
+        let data: Data?
+        do {
+            data = try json.rawData()
+        } catch _ {
+            data = nil
+        }
+        let string = json.rawString()
+        XCTAssertNotNil(data)
+        XCTAssertNotNil(string)
+    }
+}
@@ -0,0 +1,240 @@
+//  SequenceTypeTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class SequenceTypeTests: XCTestCase {
+
+    func testJSONFile() {
+        if let file = Bundle(for: BaseTests.self).path(forResource: "Tests", ofType: "json") {
+            let testData = try? Data(contentsOf: URL(fileURLWithPath: file))
+            guard let json = try? JSON(data: testData!) else {
+                XCTFail("Unable to parse the data")
+                return
+            }
+            for (index, sub) in json {
+                switch (index as NSString).integerValue {
+                case 0:
+                    XCTAssertTrue(sub["id_str"] == "240558470661799936")
+                case 1:
+                    XCTAssertTrue(sub["id_str"] == "240556426106372096")
+                case 2:
+                    XCTAssertTrue(sub["id_str"] == "240539141056638977")
+                default:
+                    continue
+                }
+            }
+        } else {
+            XCTFail("Can't find the test JSON file")
+        }
+    }
+
+    func testArrayAllNumber() {
+        var json: JSON = [1, 2.0, 3.3, 123456789, 987654321.123456789]
+        XCTAssertEqual(json.count, 5)
+
+        var index = 0
+        var array = [NSNumber]()
+        for (i, sub) in json {
+            XCTAssertEqual(sub, json[index])
+            XCTAssertEqual(i, "\(index)")
+            array.append(sub.number!)
+            index += 1
+        }
+        XCTAssertEqual(index, 5)
+        XCTAssertEqual(array, [1, 2.0, 3.3, 123456789, 987654321.123456789])
+    }
+
+    func testArrayAllBool() {
+        var json: JSON = JSON([true, false, false, true, true])
+        XCTAssertEqual(json.count, 5)
+
+        var index = 0
+        var array = [Bool]()
+        for (i, sub) in json {
+            XCTAssertEqual(sub, json[index])
+            XCTAssertEqual(i, "\(index)")
+            array.append(sub.bool!)
+            index += 1
+        }
+        XCTAssertEqual(index, 5)
+        XCTAssertEqual(array, [true, false, false, true, true])
+    }
+
+    func testArrayAllString() {
+        var json: JSON = JSON(rawValue: ["aoo", "bpp", "zoo"] as NSArray)!
+        XCTAssertEqual(json.count, 3)
+
+        var index = 0
+        var array = [String]()
+        for (i, sub) in json {
+            XCTAssertEqual(sub, json[index])
+            XCTAssertEqual(i, "\(index)")
+            array.append(sub.string!)
+            index += 1
+        }
+        XCTAssertEqual(index, 3)
+        XCTAssertEqual(array, ["aoo", "bpp", "zoo"])
+    }
+
+    func testArrayWithNull() {
+        var json: JSON = JSON(rawValue: ["aoo", "bpp", NSNull(), "zoo"] as NSArray)!
+        XCTAssertEqual(json.count, 4)
+
+        var index = 0
+        var array = [AnyObject]()
+        for (i, sub) in json {
+            XCTAssertEqual(sub, json[index])
+            XCTAssertEqual(i, "\(index)")
+            array.append(sub.object as AnyObject)
+            index += 1
+        }
+        XCTAssertEqual(index, 4)
+        XCTAssertEqual(array[0] as? String, "aoo")
+        XCTAssertEqual(array[2] as? NSNull, NSNull())
+    }
+
+    func testArrayAllDictionary() {
+        var json: JSON = [["1": 1, "2": 2], ["a": "A", "b": "B"], ["null": NSNull()]]
+        XCTAssertEqual(json.count, 3)
+
+        var index = 0
+        var array = [AnyObject]()
+        for (i, sub) in json {
+            XCTAssertEqual(sub, json[index])
+            XCTAssertEqual(i, "\(index)")
+            array.append(sub.object as AnyObject)
+            index += 1
+        }
+        XCTAssertEqual(index, 3)
+        XCTAssertEqual((array[0] as! [String: Int])["1"]!, 1)
+        XCTAssertEqual((array[0] as! [String: Int])["2"]!, 2)
+        XCTAssertEqual((array[1] as! [String: String])["a"]!, "A")
+        XCTAssertEqual((array[1] as! [String: String])["b"]!, "B")
+        XCTAssertEqual((array[2] as! [String: NSNull])["null"]!, NSNull())
+    }
+
+    func testDictionaryAllNumber() {
+        var json: JSON = ["double": 1.11111, "int": 987654321]
+        XCTAssertEqual(json.count, 2)
+
+        var index = 0
+        var dictionary = [String: NSNumber]()
+        for (key, sub) in json {
+            XCTAssertEqual(sub, json[key])
+            dictionary[key] = sub.number!
+            index += 1
+        }
+
+        XCTAssertEqual(index, 2)
+        XCTAssertEqual(dictionary["double"]! as NSNumber, 1.11111)
+        XCTAssertEqual(dictionary["int"]! as NSNumber, 987654321)
+    }
+
+    func testDictionaryAllBool() {
+        var json: JSON = ["t": true, "f": false, "false": false, "tr": true, "true": true]
+        XCTAssertEqual(json.count, 5)
+
+        var index = 0
+        var dictionary = [String: Bool]()
+        for (key, sub) in json {
+            XCTAssertEqual(sub, json[key])
+            dictionary[key] = sub.bool!
+            index += 1
+        }
+
+        XCTAssertEqual(index, 5)
+        XCTAssertEqual(dictionary["t"]! as Bool, true)
+        XCTAssertEqual(dictionary["false"]! as Bool, false)
+    }
+
+    func testDictionaryAllString() {
+        var json: JSON = JSON(rawValue: ["a": "aoo", "bb": "bpp", "z": "zoo"] as NSDictionary)!
+        XCTAssertEqual(json.count, 3)
+
+        var index = 0
+        var dictionary = [String: String]()
+        for (key, sub) in json {
+            XCTAssertEqual(sub, json[key])
+            dictionary[key] = sub.string!
+            index += 1
+        }
+
+        XCTAssertEqual(index, 3)
+        XCTAssertEqual(dictionary["a"]! as String, "aoo")
+        XCTAssertEqual(dictionary["bb"]! as String, "bpp")
+    }
+
+    func testDictionaryWithNull() {
+        var json: JSON = JSON(rawValue: ["a": "aoo", "bb": "bpp", "null": NSNull(), "z": "zoo"] as NSDictionary)!
+        XCTAssertEqual(json.count, 4)
+
+        var index = 0
+        var dictionary = [String: AnyObject]()
+        for (key, sub) in json {
+            XCTAssertEqual(sub, json[key])
+            dictionary[key] = sub.object as AnyObject?
+            index += 1
+        }
+
+        XCTAssertEqual(index, 4)
+        XCTAssertEqual(dictionary["a"]! as? String, "aoo")
+        XCTAssertEqual(dictionary["bb"]! as? String, "bpp")
+        XCTAssertEqual(dictionary["null"]! as? NSNull, NSNull())
+    }
+
+    func testDictionaryAllArray() {
+        var json: JSON = JSON (["Number": [NSNumber(value: 1), NSNumber(value: 2.123456), NSNumber(value: 123456789)], "String": ["aa", "bbb", "cccc"], "Mix": [true, "766", NSNull(), 655231.9823]])
+
+        XCTAssertEqual(json.count, 3)
+
+        var index = 0
+        var dictionary = [String: AnyObject]()
+        for (key, sub) in json {
+            XCTAssertEqual(sub, json[key])
+            dictionary[key] = sub.object as AnyObject?
+            index += 1
+        }
+
+        XCTAssertEqual(index, 3)
+        XCTAssertEqual((dictionary["Number"] as! NSArray)[0] as? Int, 1)
+        XCTAssertEqual((dictionary["Number"] as! NSArray)[1] as? Double, 2.123456)
+        XCTAssertEqual((dictionary["String"] as! NSArray)[0] as? String, "aa")
+        XCTAssertEqual((dictionary["Mix"] as! NSArray)[0] as? Bool, true)
+        XCTAssertEqual((dictionary["Mix"] as! NSArray)[1] as? String, "766")
+        XCTAssertEqual((dictionary["Mix"] as! NSArray)[2] as? NSNull, NSNull())
+        XCTAssertEqual((dictionary["Mix"] as! NSArray)[3] as? Double, 655231.9823)
+    }
+
+    func testDictionaryIteratingPerformance() {
+        var json: JSON = [:]
+        for i in 1...1000 {
+            json[String(i)] = "hello"
+        }
+        measure {
+            for (key, value) in json {
+                print(key, value)
+            }
+        }
+    }
+}
@@ -0,0 +1,80 @@
+//  StringTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class StringTests: XCTestCase {
+
+    func testString() {
+        //getter
+        var json = JSON("abcdefg hijklmn;opqrst.?+_()")
+        XCTAssertEqual(json.string!, "abcdefg hijklmn;opqrst.?+_()")
+        XCTAssertEqual(json.stringValue, "abcdefg hijklmn;opqrst.?+_()")
+
+        json.string = "12345?67890.@#"
+        XCTAssertEqual(json.string!, "12345?67890.@#")
+        XCTAssertEqual(json.stringValue, "12345?67890.@#")
+    }
+
+    func testUrl() {
+        let json = JSON("http://github.com")
+        XCTAssertEqual(json.url!, URL(string: "http://github.com")!)
+    }
+
+    func testBool() {
+        let json = JSON("true")
+        XCTAssertTrue(json.boolValue)
+    }
+
+    func testBoolWithY() {
+        let json = JSON("Y")
+        XCTAssertTrue(json.boolValue)
+    }
+
+    func testBoolWithT() {
+        let json = JSON("T")
+        XCTAssertTrue(json.boolValue)
+    }
+
+    func testBoolWithYes() {
+        let json = JSON("Yes")
+        XCTAssertTrue(json.boolValue)
+    }
+
+    func testBoolWith1() {
+        let json = JSON("1")
+        XCTAssertTrue(json.boolValue)
+    }
+
+    func testUrlPercentEscapes() {
+        let emDash = "\\u2014"
+        let urlString = "http://examble.com/unencoded" + emDash + "string"
+        guard let encodedURLString = urlString.addingPercentEncoding(withAllowedCharacters: CharacterSet.urlQueryAllowed) else {
+            return XCTFail("Couldn't encode URL string \(urlString)")
+        }
+        let json = JSON(urlString)
+        XCTAssertEqual(json.url!, URL(string: encodedURLString)!, "Wrong unpacked ")
+        let preEscaped = JSON(encodedURLString)
+        XCTAssertEqual(preEscaped.url!, URL(string: encodedURLString)!, "Wrong unpacked ")
+    }
+}
@@ -0,0 +1,267 @@
+//  SubscriptTests.swift
+//
+//  Copyright (c) 2014 - 2017 Pinglin Tang
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+
+import XCTest
+import SwiftyJSON
+
+class SubscriptTests: XCTestCase {
+
+    func testArrayAllNumber() {
+        var json: JSON = [1, 2.0, 3.3, 123456789, 987654321.123456789]
+        XCTAssertTrue(json == [1, 2.0, 3.3, 123456789, 987654321.123456789])
+        XCTAssertTrue(json[0] == 1)
+        XCTAssertEqual(json[1].double!, 2.0)
+        XCTAssertTrue(json[2].floatValue == 3.3)
+        XCTAssertEqual(json[3].int!, 123456789)
+        XCTAssertEqual(json[4].doubleValue, 987654321.123456789)
+
+        json[0] = 1.9
+        json[1] = 2.899
+        json[2] = 3.567
+        json[3] = 0.999
+        json[4] = 98732
+
+        XCTAssertTrue(json[0] == 1.9)
+        XCTAssertEqual(json[1].doubleValue, 2.899)
+        XCTAssertTrue(json[2] == 3.567)
+        XCTAssertTrue(json[3].float! == 0.999)
+        XCTAssertTrue(json[4].intValue == 98732)
+    }
+
+    func testArrayAllBool() {
+        var json: JSON = [true, false, false, true, true]
+        XCTAssertTrue(json == [true, false, false, true, true])
+        XCTAssertTrue(json[0] == true)
+        XCTAssertTrue(json[1] == false)
+        XCTAssertTrue(json[2] == false)
+        XCTAssertTrue(json[3] == true)
+        XCTAssertTrue(json[4] == true)
+
+        json[0] = false
+        json[4] = true
+        XCTAssertTrue(json[0] == false)
+        XCTAssertTrue(json[4] == true)
+    }
+
+    func testArrayAllString() {
+        var json: JSON = JSON(rawValue: ["aoo", "bpp", "zoo"] as NSArray)!
+        XCTAssertTrue(json == ["aoo", "bpp", "zoo"])
+        XCTAssertTrue(json[0] == "aoo")
+        XCTAssertTrue(json[1] == "bpp")
+        XCTAssertTrue(json[2] == "zoo")
+
+        json[1] = "update"
+        XCTAssertTrue(json[0] == "aoo")
+        XCTAssertTrue(json[1] == "update")
+        XCTAssertTrue(json[2] == "zoo")
+    }
+
+    func testArrayWithNull() {
+        var json: JSON = JSON(rawValue: ["aoo", "bpp", NSNull(), "zoo"] as NSArray)!
+        XCTAssertTrue(json[0] == "aoo")
+        XCTAssertTrue(json[1] == "bpp")
+        XCTAssertNil(json[2].string)
+        XCTAssertNotNil(json[2].null)
+        XCTAssertTrue(json[3] == "zoo")
+
+        json[2] = "update"
+        json[3] = JSON(NSNull())
+        XCTAssertTrue(json[0] == "aoo")
+        XCTAssertTrue(json[1] == "bpp")
+        XCTAssertTrue(json[2] == "update")
+        XCTAssertNil(json[3].string)
+        XCTAssertNotNil(json[3].null)
+    }
+
+    func testArrayAllDictionary() {
+        var json: JSON = [["1": 1, "2": 2], ["a": "A", "b": "B"], ["null": NSNull()]]
+        XCTAssertTrue(json[0] == ["1": 1, "2": 2])
+        XCTAssertEqual(json[1].dictionary!, ["a": "A", "b": "B"])
+        XCTAssertEqual(json[2], JSON(["null": NSNull()]))
+        XCTAssertTrue(json[0]["1"] == 1)
+        XCTAssertTrue(json[0]["2"] == 2)
+        XCTAssertEqual(json[1]["a"], JSON(rawValue: "A")!)
+        XCTAssertEqual(json[1]["b"], JSON("B"))
+        XCTAssertNotNil(json[2]["null"].null)
+        XCTAssertNotNil(json[2, "null"].null)
+        let keys: [JSONSubscriptType] = [1, "a"]
+        XCTAssertEqual(json[keys], JSON(rawValue: "A")!)
+    }
+
+    func testDictionaryAllNumber() {
+        var json: JSON = ["double": 1.11111, "int": 987654321]
+        XCTAssertEqual(json["double"].double!, 1.11111)
+        XCTAssertTrue(json["int"] == 987654321)
+
+        json["double"] = 2.2222
+        json["int"] = 123456789
+        json["add"] = 7890
+        XCTAssertTrue(json["double"] == 2.2222)
+        XCTAssertEqual(json["int"].doubleValue, 123456789.0)
+        XCTAssertEqual(json["add"].intValue, 7890)
+    }
+
+    func testDictionaryAllBool() {
+        var json: JSON = ["t": true, "f": false, "false": false, "tr": true, "true": true, "yes": true, "1": true]
+        XCTAssertTrue(json["1"] == true)
+        XCTAssertTrue(json["yes"] == true)
+        XCTAssertTrue(json["t"] == true)
+        XCTAssertTrue(json["f"] == false)
+        XCTAssertTrue(json["false"] == false)
+        XCTAssertTrue(json["tr"] == true)
+        XCTAssertTrue(json["true"] == true)
+
+        json["f"] = true
+        json["tr"] = false
+        XCTAssertTrue(json["f"] == true)
+        XCTAssertTrue(json["tr"] == JSON(false))
+    }
+
+    func testDictionaryAllString() {
+        var json: JSON = JSON(rawValue: ["a": "aoo", "bb": "bpp", "z": "zoo"] as NSDictionary)!
+        XCTAssertTrue(json["a"] == "aoo")
+        XCTAssertEqual(json["bb"], JSON("bpp"))
+        XCTAssertTrue(json["z"] == "zoo")
+
+        json["bb"] = "update"
+        XCTAssertTrue(json["a"] == "aoo")
+        XCTAssertTrue(json["bb"] == "update")
+        XCTAssertTrue(json["z"] == "zoo")
+    }
+
+    func testDictionaryWithNull() {
+        var json: JSON = JSON(rawValue: ["a": "aoo", "bb": "bpp", "null": NSNull(), "z": "zoo"] as NSDictionary)!
+        XCTAssertTrue(json["a"] == "aoo")
+        XCTAssertEqual(json["bb"], JSON("bpp"))
+        XCTAssertEqual(json["null"], JSON(NSNull()))
+        XCTAssertTrue(json["z"] == "zoo")
+
+        json["null"] = "update"
+        XCTAssertTrue(json["a"] == "aoo")
+        XCTAssertTrue(json["null"] == "update")
+        XCTAssertTrue(json["z"] == "zoo")
+    }
+
+    func testDictionaryAllArray() {
+        //Swift bug: [1, 2.01,3.09] is convert to [1, 2, 3] (Array<Int>)
+        let json: JSON = JSON ([[NSNumber(value: 1), NSNumber(value: 2.123456), NSNumber(value: 123456789)], ["aa", "bbb", "cccc"], [true, "766", NSNull(), 655231.9823]] as NSArray)
+        XCTAssertTrue(json[0] == [1, 2.123456, 123456789])
+        XCTAssertEqual(json[0][1].double!, 2.123456)
+        XCTAssertTrue(json[0][2] == 123456789)
+        XCTAssertTrue(json[1][0] == "aa")
+        XCTAssertTrue(json[1] == ["aa", "bbb", "cccc"])
+        XCTAssertTrue(json[2][0] == true)
+        XCTAssertTrue(json[2][1] == "766")
+        XCTAssertTrue(json[[2, 1]] == "766")
+        XCTAssertEqual(json[2][2], JSON(NSNull()))
+        XCTAssertEqual(json[2, 2], JSON(NSNull()))
+        XCTAssertEqual(json[2][3], JSON(655231.9823))
+        XCTAssertEqual(json[2, 3], JSON(655231.9823))
+        XCTAssertEqual(json[[2, 3]], JSON(655231.9823))
+    }
+
+    func testOutOfBounds() {
+        let json: JSON = JSON ([[NSNumber(value: 1), NSNumber(value: 2.123456), NSNumber(value: 123456789)], ["aa", "bbb", "cccc"], [true, "766", NSNull(), 655231.9823]] as NSArray)
+        XCTAssertEqual(json[9], JSON.null)
+        XCTAssertEqual(json[-2].error, SwiftyJSONError.indexOutOfBounds)
+        XCTAssertEqual(json[6].error, SwiftyJSONError.indexOutOfBounds)
+        XCTAssertEqual(json[9][8], JSON.null)
+        XCTAssertEqual(json[8][7].error, SwiftyJSONError.indexOutOfBounds)
+        XCTAssertEqual(json[8, 7].error, SwiftyJSONError.indexOutOfBounds)
+        XCTAssertEqual(json[999].error, SwiftyJSONError.indexOutOfBounds)
+    }
+
+    func testErrorWrongType() {
+        let json = JSON(12345)
+        XCTAssertEqual(json[9], JSON.null)
+        XCTAssertEqual(json[9].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json[8][7].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json["name"], JSON.null)
+        XCTAssertEqual(json["name"].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json[0]["name"].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json["type"]["name"].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json["name"][99].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json[1, "Value"].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json[1, 2, "Value"].error, SwiftyJSONError.wrongType)
+        XCTAssertEqual(json[[1, 2, "Value"]].error, SwiftyJSONError.wrongType)
+    }
+
+    func testErrorNotExist() {
+        let json: JSON = ["name": "NAME", "age": 15]
+        XCTAssertEqual(json["Type"], JSON.null)
+        XCTAssertEqual(json["Type"].error, SwiftyJSONError.notExist)
+        XCTAssertEqual(json["Type"][1].error, SwiftyJSONError.notExist)
+        XCTAssertEqual(json["Type", 1].error, SwiftyJSONError.notExist)
+        XCTAssertEqual(json["Type"]["Value"].error, SwiftyJSONError.notExist)
+        XCTAssertEqual(json["Type", "Value"].error, SwiftyJSONError.notExist)
+    }
+
+    func testMultilevelGetter() {
+        let json: JSON = [[[[["one": 1]]]]]
+        XCTAssertEqual(json[[0, 0, 0, 0, "one"]].int!, 1)
+        XCTAssertEqual(json[0, 0, 0, 0, "one"].int!, 1)
+        XCTAssertEqual(json[0][0][0][0]["one"].int!, 1)
+    }
+
+    func testMultilevelSetter1() {
+        var json: JSON = [[[[["num": 1]]]]]
+        json[0, 0, 0, 0, "num"] = 2
+        XCTAssertEqual(json[[0, 0, 0, 0, "num"]].intValue, 2)
+        json[0, 0, 0, 0, "num"] = JSON.null
+        XCTAssertEqual(json[0, 0, 0, 0, "num"].null!, NSNull())
+        json[0, 0, 0, 0, "num"] = 100.009
+        XCTAssertEqual(json[0][0][0][0]["num"].doubleValue, 100.009)
+        json[[0, 0, 0, 0]] = ["name": "Jack"]
+        XCTAssertEqual(json[0, 0, 0, 0, "name"].stringValue, "Jack")
+        XCTAssertEqual(json[0][0][0][0]["name"].stringValue, "Jack")
+        XCTAssertEqual(json[[0, 0, 0, 0, "name"]].stringValue, "Jack")
+        json[[0, 0, 0, 0, "name"]].string = "Mike"
+        XCTAssertEqual(json[0, 0, 0, 0, "name"].stringValue, "Mike")
+        let path: [JSONSubscriptType] = [0, 0, 0, 0, "name"]
+        json[path].string = "Jim"
+        XCTAssertEqual(json[path].stringValue, "Jim")
+    }
+
+    func testMultilevelSetter2() {
+        var json: JSON = ["user": ["id": 987654, "info": ["name": "jack", "email": "jack@gmail.com"], "feeds": [98833, 23443, 213239, 23232]]]
+        json["user", "info", "name"] = "jim"
+        XCTAssertEqual(json["user", "id"], 987654)
+        XCTAssertEqual(json["user", "info", "name"], "jim")
+        XCTAssertEqual(json["user", "info", "email"], "jack@gmail.com")
+        XCTAssertEqual(json["user", "feeds"], [98833, 23443, 213239, 23232])
+        json["user", "info", "email"] = "jim@hotmail.com"
+        XCTAssertEqual(json["user", "id"], 987654)
+        XCTAssertEqual(json["user", "info", "name"], "jim")
+        XCTAssertEqual(json["user", "info", "email"], "jim@hotmail.com")
+        XCTAssertEqual(json["user", "feeds"], [98833, 23443, 213239, 23232])
+        json["user", "info"] = ["name": "tom", "email": "tom@qq.com"]
+        XCTAssertEqual(json["user", "id"], 987654)
+        XCTAssertEqual(json["user", "info", "name"], "tom")
+        XCTAssertEqual(json["user", "info", "email"], "tom@qq.com")
+        XCTAssertEqual(json["user", "feeds"], [98833, 23443, 213239, 23232])
+        json["user", "feeds"] = [77323, 2313, 4545, 323]
+        XCTAssertEqual(json["user", "id"], 987654)
+        XCTAssertEqual(json["user", "info", "name"], "tom")
+        XCTAssertEqual(json["user", "info", "email"], "tom@qq.com")
+        XCTAssertEqual(json["user", "feeds"], [77323, 2313, 4545, 323])
+    }
+}
@@ -127,7 +127,7 @@ class PerformanceTests: XCTestCase {
        self.measure {
            autoreleasepool {
                if let dictionary = json.dictionary {
-                    XCTAssertTrue(dictionary.count > 0)
+                    XCTAssertTrue(dictionary.count == 100001)
                } else {
                    XCTFail("dictionary should not be nil")
                }
@@ -0,0 +1,345 @@
+[
+  {
+  "coordinates":null,
+  "truncated":false,
+  "created_at":"Tue Aug 28 21:16:23 +0000 2012",
+  "favorited":false,
+  "id_str":"240558470661799936",
+  "in_reply_to_user_id_str":null,
+  "entities":{
+  "urls":[
+  
+  ],
+  "hashtags":[
+  
+  ],
+  "user_mentions":[
+  
+  ]
+  },
+  "text":"just another test",
+  "contributors":null,
+  "id":240558470661799936,
+  "retweet_count":0,
+  "in_reply_to_status_id_str":null,
+  "geo":null,
+  "retweeted":false,
+  "in_reply_to_user_id":null,
+  "place":null,
+  "source":"&lt;a href=\"//realitytechnicians.com\" rel=\"\"nofollow\"\"&gt;OAuth Dancer Reborn&lt;/a&gt;",
+  "user":{
+  "name":"OAuth Dancer",
+  "profile_sidebar_fill_color":"DDEEF6",
+  "profile_background_tile":true,
+  "profile_sidebar_border_color":"C0DEED",
+  "profile_image_url":"http://a0.twimg.com/profile_images/730275945/oauth-dancer_normal.jpg",
+  "created_at":"Wed Mar 03 19:37:35 +0000 2010",
+  "location":"San Francisco, CA",
+  "follow_request_sent":false,
+  "id_str":"119476949",
+  "is_translator":false,
+  "profile_link_color":"0084B4",
+  "entities":{
+  "url":{
+  "urls":[
+          {
+          "expanded_url":null,
+          "url":"http://bit.ly/oauth-dancer",
+          "indices":[
+                     0,
+                     26
+                     ],
+          "display_url":null
+          }
+          ]
+  },
+  "description":null
+  },
+  "default_profile":false,
+  "url":"http://bit.ly/oauth-dancer",
+  "contributors_enabled":false,
+  "favourites_count":7,
+  "utc_offset":null,
+  "profile_image_url_https":"https://si0.twimg.com/profile_images/730275945/oauth-dancer_normal.jpg",
+  "id":119476949,
+  "listed_count":1,
+  "profile_use_background_image":true,
+  "profile_text_color":"333333",
+  "followers_count":28,
+  "lang":"en",
+  "protected":false,
+  "geo_enabled":true,
+  "notifications":false,
+  "description":"",
+  "profile_background_color":"C0DEED",
+  "verified":false,
+  "time_zone":null,
+  "profile_background_image_url_https":"https://si0.twimg.com/profile_background_images/80151733/oauth-dance.png",
+  "statuses_count":166,
+  "profile_background_image_url":"http://a0.twimg.com/profile_background_images/80151733/oauth-dance.png",
+  "default_profile_image":false,
+  "friends_count":14,
+  "following":false,
+  "show_all_inline_media":false,
+  "screen_name":"oauth_dancer"
+  },
+  "in_reply_to_screen_name":null,
+  "in_reply_to_status_id":null
+  },
+  {
+  "coordinates":{
+  "coordinates":[
+                 -122.25831,
+                 37.871609
+                 ],
+  "type":"Point"
+  },
+  "truncated":false,
+  "created_at":"Tue Aug 28 21:08:15 +0000 2012",
+  "favorited":false,
+  "id_str":"240556426106372096",
+  "in_reply_to_user_id_str":null,
+  "entities":{
+  "urls":[
+          {
+          "expanded_url":"http://blogs.ischool.berkeley.edu/i290-abdt-s12/",
+          "url":"http://t.co/bfj7zkDJ",
+          "indices":[
+                     79,
+                     99
+                     ],
+          "display_url":"blogs.ischool.berkeley.edu/i290-abdt-s12/"
+          }
+          ],
+  "hashtags":[
+  
+  ],
+  "user_mentions":[
+                   {
+                   "name":"Cal",
+                   "id_str":"17445752",
+                   "id":17445752,
+                   "indices":[
+                              60,
+                              64
+                              ],
+                   "screen_name":"Cal"
+                   },
+                   {
+                   "name":"Othman Laraki",
+                   "id_str":"20495814",
+                   "id":20495814,
+                   "indices":[
+                              70,
+                              77
+                              ],
+                   "screen_name":"othman"
+                   }
+                   ]
+  },
+  "text":"lecturing at the \"analyzing big data with twitter\" class at @cal with @othman  http://t.co/bfj7zkDJ",
+  "contributors":null,
+  "id":240556426106372096,
+  "retweet_count":3,
+  "in_reply_to_status_id_str":null,
+  "geo":{
+  "coordinates":[
+                 37.871609,
+                 -122.25831
+                 ],
+  "type":"Point"
+  },
+  "retweeted":false,
+  "possibly_sensitive":false,
+  "in_reply_to_user_id":null,
+  "place":{
+  "name":"Berkeley",
+  "country_code":"US",
+  "country":"United States",
+  "attributes":{
+  
+  },
+  "url":"http://api.twitter.com/1/geo/id/5ef5b7f391e30aff.json",
+  "id":"5ef5b7f391e30aff",
+  "bounding_box":{
+  "coordinates":[
+                 [
+                  [
+                   -122.367781,
+                   37.835727
+                   ],
+                  [
+                   -122.234185,
+                   37.835727
+                   ],
+                  [
+                   -122.234185,
+                   37.905824
+                   ],
+                  [
+                   -122.367781,
+                   37.905824
+                   ]
+                  ]
+                 ],
+  "type":"Polygon"
+  },
+  "full_name":"Berkeley, CA",
+  "place_type":"city"
+  },
+  "source":"&lt;a href=\"//www.apple.com\"\" rel=\"\"nofollow\"\"&gt;Safari on iOS&lt;/a&gt;",
+  "user":{
+  "name":"Raffi Krikorian",
+  "profile_sidebar_fill_color":"DDEEF6",
+  "profile_background_tile":false,
+  "profile_sidebar_border_color":"C0DEED",
+  "profile_image_url":"http://a0.twimg.com/profile_images/1270234259/raffi-headshot-casual_normal.png",
+  "created_at":"Sun Aug 19 14:24:06 +0000 2007",
+  "location":"San Francisco, California",
+  "follow_request_sent":false,
+  "id_str":"8285392",
+  "is_translator":false,
+  "profile_link_color":"0084B4",
+  "entities":{
+  "url":{
+  "urls":[
+          {
+          "expanded_url":"http://about.me/raffi.krikorian",
+          "url":"http://t.co/eNmnM6q",
+          "indices":[
+                     0,
+                     19
+                     ],
+          "display_url":"about.me/raffi.krikorian"
+          }
+          ]
+  },
+  "description":{
+  "urls":[
+  
+  ]
+  }
+  },
+  "default_profile":true,
+  "url":"http://t.co/eNmnM6q",
+  "contributors_enabled":false,
+  "favourites_count":724,
+  "utc_offset":-28800,
+  "profile_image_url_https":"https://si0.twimg.com/profile_images/1270234259/raffi-headshot-casual_normal.png",
+  "id":8285392,
+  "listed_count":619,
+  "profile_use_background_image":true,
+  "profile_text_color":"333333",
+  "followers_count":18752,
+  "lang":"en",
+  "protected":false,
+  "geo_enabled":true,
+  "notifications":false,
+  "description":"Director of @twittereng's Platform Services. I break things.",
+  "profile_background_color":"C0DEED",
+  "verified":false,
+  "time_zone":"Pacific Time (US &amp; Canada)",
+  "profile_background_image_url_https":"https://si0.twimg.com/images/themes/theme1/bg.png",
+  "statuses_count":5007,
+  "profile_background_image_url":"http://a0.twimg.com/images/themes/theme1/bg.png",
+  "default_profile_image":false,
+  "friends_count":701,
+  "following":true,
+  "show_all_inline_media":true,
+  "screen_name":"raffi"
+  },
+  "in_reply_to_screen_name":null,
+  "in_reply_to_status_id":null
+  },
+  {
+  "coordinates":null,
+  "truncated":false,
+  "created_at":"Tue Aug 28 19:59:34 +0000 2012",
+  "favorited":false,
+  "id_str":"240539141056638977",
+  "in_reply_to_user_id_str":null,
+  "entities":{
+  "urls":[
+  
+  ],
+  "hashtags":[
+  
+  ],
+  "user_mentions":[
+  
+  ]
+  },
+  "text":"You'd be right more often if you thought you were wrong.",
+  "contributors":null,
+  "id":240539141056638977,
+  "retweet_count":1,
+  "in_reply_to_status_id_str":null,
+  "geo":null,
+  "retweeted":false,
+  "in_reply_to_user_id":null,
+  "place":null,
+  "source":"web",
+  "user":{
+  "name":"Taylor Singletary",
+  "profile_sidebar_fill_color":"FBFBFB",
+  "profile_background_tile":true,
+  "profile_sidebar_border_color":"000000",
+  "profile_image_url":"http://a0.twimg.com/profile_images/2546730059/f6a8zq58mg1hn0ha8vie_normal.jpeg",
+  "created_at":"Wed Mar 07 22:23:19 +0000 2007",
+  "location":"San Francisco, CA",
+  "follow_request_sent":false,
+  "id_str":"819797",
+  "is_translator":false,
+  "profile_link_color":"c71818",
+  "entities":{
+  "url":{
+  "urls":[
+          {
+          "expanded_url":"http://www.rebelmouse.com/episod/",
+          "url":"http://t.co/Lxw7upbN",
+          "indices":[
+                     0,
+                     20
+                     ],
+          "display_url":"rebelmouse.com/episod/"
+          }
+          ]
+  },
+  "description":{
+  "urls":[
+  
+  ]
+  }
+  },
+  "default_profile":false,
+  "url":"http://t.co/Lxw7upbN",
+  "contributors_enabled":false,
+  "favourites_count":15990,
+  "utc_offset":-28800,
+  "profile_image_url_https":"https://si0.twimg.com/profile_images/2546730059/f6a8zq58mg1hn0ha8vie_normal.jpeg",
+  "id":819797,
+  "listed_count":340,
+  "profile_use_background_image":true,
+  "profile_text_color":"D20909",
+  "followers_count":7126,
+  "lang":"en",
+  "protected":false,
+  "geo_enabled":true,
+  "notifications":false,
+  "description":"Reality Technician, Twitter API team, synthesizer enthusiast; a most excellent adventure in timelines. I know it's hard to believe in something you can't see.",
+  "profile_background_color":"000000",
+  "verified":false,
+  "time_zone":"Pacific Time (US &amp; Canada)",
+  "profile_background_image_url_https":"https://si0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png",
+  "statuses_count":18076,
+  "profile_background_image_url":"http://a0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png",
+  "default_profile_image":false,
+  "friends_count":5444,
+  "following":true,
+  "show_all_inline_media":true,
+  "screen_name":"episod"
+  },
+  "in_reply_to_screen_name":null,
+  "in_reply_to_status_id":null
+  }
+  ]
@@ -1,21 +1,674 @@
-MIT License
+GNU GENERAL PUBLIC LICENSE
+                      Version 3, 29 June 2007

-Copyright (c) 2018 acheronfail
+ Copyright (C) 2007 Free Software Foundation, Inc. {http://fsf.org/}
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.

-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+                            Preamble

-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.

-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    {one line to give the program's name and a brief idea of what it does.}
+    Copyright (C) {year}  {name of author}
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see {http://www.gnu.org/licenses/}.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    {{project}}  Copyright (C) {{year}}  {{fullname}}
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+{http://www.gnu.org/licenses/}.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+{http://www.gnu.org/philosophy/why-not-lgpl.html}.
@@ -7,7 +7,9 @@
 	objects = {

 /* Begin PBXBuildFile section */
+		15349DB820BAE3F70071CAA1 /* NSBezierPath.swift in Sources */ = {isa = PBXBuildFile; fileRef = 15349DB720BAE3F70071CAA1 /* NSBezierPath.swift */; };
 		15492103207B53AE00E45BBC /* Util.swift in Sources */ = {isa = PBXBuildFile; fileRef = 15492102207B53AE00E45BBC /* Util.swift */; };
+		15493F6720BE6E0F007B2BA5 /* CGImage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 15493F6620BE6E0F007B2BA5 /* CGImage.swift */; };
 		155D2C03204F61220087478B /* Credits.rtfd in Resources */ = {isa = PBXBuildFile; fileRef = 155D2C02204F61220087478B /* Credits.rtfd */; };
 		159F304E2079A111000BD387 /* AppDelegateTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 159F304D2079A111000BD387 /* AppDelegateTests.swift */; };
 		159F30522079A147000BD387 /* PPStateTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 159F30512079A147000BD387 /* PPStateTests.swift */; };
@@ -35,6 +37,7 @@
 		BAA17B7A20B14CC100625455 /* MASShortcut.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = BAA17B7220B14CC100625455 /* MASShortcut.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
 		BAA17B7C20B14CEB00625455 /* SwiftyJSON.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = BAA17B7B20B14CEB00625455 /* SwiftyJSON.framework */; };
 		BAA17B7D20B14CEB00625455 /* SwiftyJSON.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = BAA17B7B20B14CEB00625455 /* SwiftyJSON.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
+		BAB6F14F221ABB3500EA11D4 /* ShowAndHideCursor.swift in Sources */ = {isa = PBXBuildFile; fileRef = BAB6F14E221ABB3500EA11D4 /* ShowAndHideCursor.swift */; };
 /* End PBXBuildFile section */

 /* Begin PBXContainerItemProxy section */
@@ -65,22 +68,24 @@
 /* End PBXCopyFilesBuildPhase section */

 /* Begin PBXFileReference section */
+		15349DB720BAE3F70071CAA1 /* NSBezierPath.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NSBezierPath.swift; sourceTree = "<group>"; };
 		15492102207B53AE00E45BBC /* Util.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Util.swift; sourceTree = "<group>"; };
+		15493F6620BE6E0F007B2BA5 /* CGImage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CGImage.swift; sourceTree = "<group>"; };
 		155D2C02204F61220087478B /* Credits.rtfd */ = {isa = PBXFileReference; lastKnownFileType = wrapper.rtfd; path = Credits.rtfd; sourceTree = "<group>"; };
 		159F304D2079A111000BD387 /* AppDelegateTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegateTests.swift; sourceTree = "<group>"; };
 		159F30512079A147000BD387 /* PPStateTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PPStateTests.swift; sourceTree = "<group>"; };
 		15A8D9712083624600D55A9B /* Helpers.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Helpers.swift; sourceTree = "<group>"; };
-		15B4E870207994AF0024FDE4 /* PixelPickerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = PixelPickerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
+		15B4E870207994AF0024FDE4 /* Pixel PickerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "Pixel PickerTests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
 		15B4E874207994AF0024FDE4 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
 		15FC8CC7204E2E2C000B5E1E /* PPState.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PPState.swift; sourceTree = "<group>"; };
-		15FF0CCC204A231800E04103 /* Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "Bridging-Header.h"; path = "PixelPicker/Bridging-Header.h"; sourceTree = "<group>"; };
-		B3B4C2BD1E25894B009F8E4E /* PixelPicker.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = PixelPicker.app; sourceTree = BUILT_PRODUCTS_DIR; };
+		15FF0CCC204A231800E04103 /* Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "Bridging-Header.h"; path = "Pixel Picker/Bridging-Header.h"; sourceTree = "<group>"; };
+		B3B4C2BD1E25894B009F8E4E /* Pixel Picker.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "Pixel Picker.app"; sourceTree = BUILT_PRODUCTS_DIR; };
 		B3B4C2C01E25894B009F8E4E /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
 		B3B4C2C21E25894B009F8E4E /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
 		B3B4C2C71E25894B009F8E4E /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
 		BA22232620AFEC1B0001069C /* ApplicationServices.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = ApplicationServices.framework; path = System/Library/Frameworks/ApplicationServices.framework; sourceTree = SDKROOT; };
 		BA22232820B04D660001069C /* AppDelegate+Menu.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "AppDelegate+Menu.swift"; sourceTree = "<group>"; };
-		BA22232A20B0E3B50001069C /* README.md */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = net.daringfireball.markdown; name = README.md; path = "/Users/cosmotherly/dev/pixel-picker/README.md"; sourceTree = "<absolute>"; };
+		BA22232A20B0E3B50001069C /* README.md */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = net.daringfireball.markdown; path = README.md; sourceTree = SOURCE_ROOT; };
 		BA71817120AE2DB400619700 /* PPMenuShortcutView.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = PPMenuShortcutView.m; sourceTree = "<group>"; };
 		BA71817320AE2DCC00619700 /* PPMenuShortcutView.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = PPMenuShortcutView.h; sourceTree = "<group>"; };
 		BA74C0F620A692D100306B27 /* PPOverlayController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PPOverlayController.swift; sourceTree = "<group>"; };
@@ -96,6 +101,7 @@
 		BAA17B7120B14CC000625455 /* CleanroomLogger.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = CleanroomLogger.framework; path = Carthage/Build/Mac/CleanroomLogger.framework; sourceTree = "<group>"; };
 		BAA17B7220B14CC100625455 /* MASShortcut.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = MASShortcut.framework; path = Carthage/Build/Mac/MASShortcut.framework; sourceTree = "<group>"; };
 		BAA17B7B20B14CEB00625455 /* SwiftyJSON.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = SwiftyJSON.framework; path = Carthage/Build/Mac/SwiftyJSON.framework; sourceTree = "<group>"; };
+		BAB6F14E221ABB3500EA11D4 /* ShowAndHideCursor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ShowAndHideCursor.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */

 /* Begin PBXFrameworksBuildPhase section */
@@ -133,7 +139,7 @@
 			path = OverlayPanel;
 			sourceTree = "<group>";
 		};
-		15B4E871207994AF0024FDE4 /* PixelPickerTests */ = {
+		15B4E871207994AF0024FDE4 /* Pixel PickerTests */ = {
 			isa = PBXGroup;
 			children = (
 				159F304D2079A111000BD387 /* AppDelegateTests.swift */,
@@ -141,7 +147,7 @@
 				15A8D9712083624600D55A9B /* Helpers.swift */,
 				15B4E874207994AF0024FDE4 /* Info.plist */,
 			);
-			path = PixelPickerTests;
+			path = "Pixel PickerTests";
 			sourceTree = "<group>";
 		};
 		B3B4C2B41E25894B009F8E4E = {
@@ -152,8 +158,8 @@
 				BAA17B6F20B14CC000625455 /* LaunchAtLogin.framework */,
 				BAA17B7220B14CC100625455 /* MASShortcut.framework */,
 				15FF0CCC204A231800E04103 /* Bridging-Header.h */,
-				B3B4C2BF1E25894B009F8E4E /* PixelPicker */,
-				15B4E871207994AF0024FDE4 /* PixelPickerTests */,
+				B3B4C2BF1E25894B009F8E4E /* Pixel Picker */,
+				15B4E871207994AF0024FDE4 /* Pixel PickerTests */,
 				B3B4C2BE1E25894B009F8E4E /* Products */,
 				BA22232520AFEC1B0001069C /* Frameworks */,
 			);
@@ -162,17 +168,19 @@
 		B3B4C2BE1E25894B009F8E4E /* Products */ = {
 			isa = PBXGroup;
 			children = (
-				B3B4C2BD1E25894B009F8E4E /* PixelPicker.app */,
-				15B4E870207994AF0024FDE4 /* PixelPickerTests.xctest */,
+				B3B4C2BD1E25894B009F8E4E /* Pixel Picker.app */,
+				15B4E870207994AF0024FDE4 /* Pixel PickerTests.xctest */,
 			);
 			name = Products;
 			sourceTree = "<group>";
 		};
-		B3B4C2BF1E25894B009F8E4E /* PixelPicker */ = {
+		B3B4C2BF1E25894B009F8E4E /* Pixel Picker */ = {
 			isa = PBXGroup;
 			children = (
+				15493F6620BE6E0F007B2BA5 /* CGImage.swift */,
 				BA74C13420A6F1BE00306B27 /* ShowAndHideCursor.h */,
 				BA74C13220A6F16C00306B27 /* ShowAndHideCursor.m */,
+				BAB6F14E221ABB3500EA11D4 /* ShowAndHideCursor.swift */,
 				BA71817320AE2DCC00619700 /* PPMenuShortcutView.h */,
 				BA71817120AE2DB400619700 /* PPMenuShortcutView.m */,
 				B3B4C2C01E25894B009F8E4E /* AppDelegate.swift */,
@@ -180,6 +188,7 @@
 				BA74C14D20ADA33E00306B27 /* PPColor.swift */,
 				15FC8CC7204E2E2C000B5E1E /* PPState.swift */,
 				159ED10B207EB2EF005489ED /* OverlayPanel */,
+				15349DB720BAE3F70071CAA1 /* NSBezierPath.swift */,
 				BA74C14120AA409D00306B27 /* NSColor.swift */,
 				15492102207B53AE00E45BBC /* Util.swift */,
 				B3B4C2C21E25894B009F8E4E /* Assets.xcassets */,
@@ -187,7 +196,7 @@
 				155D2C02204F61220087478B /* Credits.rtfd */,
 				B3B4C2C71E25894B009F8E4E /* Info.plist */,
 			);
-			path = PixelPicker;
+			path = "Pixel Picker";
 			sourceTree = "<group>";
 		};
 		BA22232520AFEC1B0001069C /* Frameworks */ = {
@@ -201,9 +210,9 @@
 /* End PBXGroup section */

 /* Begin PBXNativeTarget section */
-		15B4E86F207994AF0024FDE4 /* PixelPickerTests */ = {
+		15B4E86F207994AF0024FDE4 /* Pixel PickerTests */ = {
 			isa = PBXNativeTarget;
-			buildConfigurationList = 15B4E877207994AF0024FDE4 /* Build configuration list for PBXNativeTarget "PixelPickerTests" */;
+			buildConfigurationList = 15B4E877207994AF0024FDE4 /* Build configuration list for PBXNativeTarget "Pixel PickerTests" */;
 			buildPhases = (
 				15B4E86C207994AF0024FDE4 /* Sources */,
 				15B4E86D207994AF0024FDE4 /* Frameworks */,
@@ -214,14 +223,14 @@
 			dependencies = (
 				15B4E876207994AF0024FDE4 /* PBXTargetDependency */,
 			);
-			name = PixelPickerTests;
+			name = "Pixel PickerTests";
 			productName = PixelPickerTests;
-			productReference = 15B4E870207994AF0024FDE4 /* PixelPickerTests.xctest */;
+			productReference = 15B4E870207994AF0024FDE4 /* Pixel PickerTests.xctest */;
 			productType = "com.apple.product-type.bundle.unit-test";
 		};
-		B3B4C2BC1E25894B009F8E4E /* PixelPicker */ = {
+		B3B4C2BC1E25894B009F8E4E /* Pixel Picker */ = {
 			isa = PBXNativeTarget;
-			buildConfigurationList = B3B4C2CA1E25894B009F8E4E /* Build configuration list for PBXNativeTarget "PixelPicker" */;
+			buildConfigurationList = B3B4C2CA1E25894B009F8E4E /* Build configuration list for PBXNativeTarget "Pixel Picker" */;
 			buildPhases = (
 				B3B4C2B91E25894B009F8E4E /* Sources */,
 				B3B4C2BA1E25894B009F8E4E /* Frameworks */,
@@ -233,9 +242,9 @@
 			);
 			dependencies = (
 			);
-			name = PixelPicker;
+			name = "Pixel Picker";
 			productName = PixelPicker;
-			productReference = B3B4C2BD1E25894B009F8E4E /* PixelPicker.app */;
+			productReference = B3B4C2BD1E25894B009F8E4E /* Pixel Picker.app */;
 			productType = "com.apple.product-type.application";
 		};
 /* End PBXNativeTarget section */
@@ -250,22 +259,23 @@
 				TargetAttributes = {
 					15B4E86F207994AF0024FDE4 = {
 						CreatedOnToolsVersion = 9.3;
+						LastSwiftMigration = 1000;
 						ProvisioningStyle = Automatic;
 						TestTargetID = B3B4C2BC1E25894B009F8E4E;
 					};
 					B3B4C2BC1E25894B009F8E4E = {
 						CreatedOnToolsVersion = 8.2.1;
-						DevelopmentTeam = UNR5C68RPX;
-						LastSwiftMigration = 0920;
+						LastSwiftMigration = 1000;
 						ProvisioningStyle = Automatic;
 					};
 				};
 			};
-			buildConfigurationList = B3B4C2B81E25894B009F8E4E /* Build configuration list for PBXProject "PixelPicker" */;
+			buildConfigurationList = B3B4C2B81E25894B009F8E4E /* Build configuration list for PBXProject "Pixel Picker" */;
 			compatibilityVersion = "Xcode 3.2";
 			developmentRegion = English;
 			hasScannedForEncodings = 0;
 			knownRegions = (
+				English,
 				en,
 				Base,
 			);
@@ -274,8 +284,8 @@
 			projectDirPath = "";
 			projectRoot = "";
 			targets = (
-				B3B4C2BC1E25894B009F8E4E /* PixelPicker */,
-				15B4E86F207994AF0024FDE4 /* PixelPickerTests */,
+				B3B4C2BC1E25894B009F8E4E /* Pixel Picker */,
+				15B4E86F207994AF0024FDE4 /* Pixel PickerTests */,
 			);
 		};
 /* End PBXProject section */
@@ -313,7 +323,7 @@
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
-			shellScript = "./Carthage/Build/Mac/LaunchAtLogin.framework/Resources/copy-helper.sh";
+			shellScript = "\"${PROJECT_DIR}/Carthage/Build/Mac/LaunchAtLogin.framework/Resources/copy-helper.sh\"\n";
 		};
 /* End PBXShellScriptBuildPhase section */

@@ -332,18 +342,21 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				BA74C14220AA409D00306B27 /* NSColor.swift in Sources */,
-				BA71817220AE2DB400619700 /* PPMenuShortcutView.m in Sources */,
-				15492103207B53AE00E45BBC /* Util.swift in Sources */,
-				BA74C0F820A692D100306B27 /* PPOverlayController.swift in Sources */,
-				BA74C14E20ADA33E00306B27 /* PPColor.swift in Sources */,
-				BA22232920B04D660001069C /* AppDelegate+Menu.swift in Sources */,
-				BA74C13120A6E95900306B27 /* PPOverlayPanel.swift in Sources */,
-				B3B4C2C11E25894B009F8E4E /* AppDelegate.swift in Sources */,
-				BA74C14420AA609500306B27 /* PPOverlayWrapper.swift in Sources */,
 				BA74C13320A6F16C00306B27 /* ShowAndHideCursor.m in Sources */,
-				BA74C14020AA390400306B27 /* PPOverlayPreview.swift in Sources */,
+				15349DB820BAE3F70071CAA1 /* NSBezierPath.swift in Sources */,
+				BA71817220AE2DB400619700 /* PPMenuShortcutView.m in Sources */,
+				B3B4C2C11E25894B009F8E4E /* AppDelegate.swift in Sources */,
+				BA22232920B04D660001069C /* AppDelegate+Menu.swift in Sources */,
+				BA74C14E20ADA33E00306B27 /* PPColor.swift in Sources */,
 				15FC8CC8204E2E2C000B5E1E /* PPState.swift in Sources */,
+				BA74C13120A6E95900306B27 /* PPOverlayPanel.swift in Sources */,
+				BA74C14020AA390400306B27 /* PPOverlayPreview.swift in Sources */,
+				BA74C14420AA609500306B27 /* PPOverlayWrapper.swift in Sources */,
+				BAB6F14F221ABB3500EA11D4 /* ShowAndHideCursor.swift in Sources */,
+				BA74C0F820A692D100306B27 /* PPOverlayController.swift in Sources */,
+				15493F6720BE6E0F007B2BA5 /* CGImage.swift in Sources */,
+				BA74C14220AA409D00306B27 /* NSColor.swift in Sources */,
+				15492103207B53AE00E45BBC /* Util.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -352,7 +365,7 @@
 /* Begin PBXTargetDependency section */
 		15B4E876207994AF0024FDE4 /* PBXTargetDependency */ = {
 			isa = PBXTargetDependency;
-			target = B3B4C2BC1E25894B009F8E4E /* PixelPicker */;
+			target = B3B4C2BC1E25894B009F8E4E /* Pixel Picker */;
 			targetProxy = 15B4E875207994AF0024FDE4 /* PBXContainerItemProxy */;
 		};
 /* End PBXTargetDependency section */
@@ -375,14 +388,15 @@
 					"$(PROJECT_DIR)/Carthage/Build/Mac",
 				);
 				GCC_C_LANGUAGE_STANDARD = gnu11;
-				INFOPLIST_FILE = PixelPickerTests/Info.plist;
+				INFOPLIST_FILE = "Pixel PickerTests/Info.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/../Frameworks @loader_path/../Frameworks";
 				MACOSX_DEPLOYMENT_TARGET = 10.13;
 				PRODUCT_BUNDLE_IDENTIFIER = com.acheronfail.PixelPickerTests;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_VERSION = 4.0;
-				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/PixelPicker.app/Contents/MacOS/PixelPicker";
+				SWIFT_OBJC_BRIDGING_HEADER = "Pixel Picker/Bridging-Header.h";
+				SWIFT_VERSION = 4.2;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Pixel Picker.app/Contents/MacOS/Pixel Picker";
 			};
 			name = Debug;
 		};
@@ -403,14 +417,15 @@
 					"$(PROJECT_DIR)/Carthage/Build/Mac",
 				);
 				GCC_C_LANGUAGE_STANDARD = gnu11;
-				INFOPLIST_FILE = PixelPickerTests/Info.plist;
+				INFOPLIST_FILE = "Pixel PickerTests/Info.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/../Frameworks @loader_path/../Frameworks";
 				MACOSX_DEPLOYMENT_TARGET = 10.13;
 				PRODUCT_BUNDLE_IDENTIFIER = com.acheronfail.PixelPickerTests;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_VERSION = 4.0;
-				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/PixelPicker.app/Contents/MacOS/PixelPicker";
+				SWIFT_OBJC_BRIDGING_HEADER = "Pixel Picker/Bridging-Header.h";
+				SWIFT_VERSION = 4.2;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Pixel Picker.app/Contents/MacOS/Pixel Picker";
 			};
 			name = Release;
 		};
@@ -538,21 +553,21 @@
 				CODE_SIGN_IDENTITY = "";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				DEVELOPMENT_TEAM = UNR5C68RPX;
+				DEVELOPMENT_TEAM = "";
 				FRAMEWORK_SEARCH_PATHS = (
 					"$(inherited)",
 					"$(PROJECT_DIR)/Carthage/Build/Mac",
 				);
 				GCC_C_LANGUAGE_STANDARD = c11;
-				INFOPLIST_FILE = PixelPicker/Info.plist;
+				INFOPLIST_FILE = "Pixel Picker/Info.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/../Frameworks";
 				MACOSX_DEPLOYMENT_TARGET = 10.12;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.acheronfail.pixel-picker";
+				PRODUCT_MODULE_NAME = PixelPicker;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_OBJC_BRIDGING_HEADER = "PixelPicker/Bridging-Header.h";
-				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_OBJC_BRIDGING_HEADER = "Pixel Picker/Bridging-Header.h";
+				SWIFT_VERSION = 4.2;
 			};
 			name = Debug;
 		};
@@ -564,28 +579,28 @@
 				CODE_SIGN_IDENTITY = "";
 				CODE_SIGN_STYLE = Automatic;
 				COMBINE_HIDPI_IMAGES = YES;
-				DEVELOPMENT_TEAM = UNR5C68RPX;
+				DEVELOPMENT_TEAM = "";
 				FRAMEWORK_SEARCH_PATHS = (
 					"$(inherited)",
 					"$(PROJECT_DIR)/Carthage/Build/Mac",
 				);
 				GCC_C_LANGUAGE_STANDARD = c11;
-				INFOPLIST_FILE = PixelPicker/Info.plist;
+				INFOPLIST_FILE = "Pixel Picker/Info.plist";
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/../Frameworks";
 				MACOSX_DEPLOYMENT_TARGET = 10.12;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.acheronfail.pixel-picker";
+				PRODUCT_MODULE_NAME = PixelPicker;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_OBJC_BRIDGING_HEADER = "PixelPicker/Bridging-Header.h";
-				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
-				SWIFT_VERSION = 4.0;
+				SWIFT_OBJC_BRIDGING_HEADER = "Pixel Picker/Bridging-Header.h";
+				SWIFT_VERSION = 4.2;
 			};
 			name = Release;
 		};
 /* End XCBuildConfiguration section */

 /* Begin XCConfigurationList section */
-		15B4E877207994AF0024FDE4 /* Build configuration list for PBXNativeTarget "PixelPickerTests" */ = {
+		15B4E877207994AF0024FDE4 /* Build configuration list for PBXNativeTarget "Pixel PickerTests" */ = {
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				15B4E878207994AF0024FDE4 /* Debug */,
@@ -594,7 +609,7 @@
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;
 		};
-		B3B4C2B81E25894B009F8E4E /* Build configuration list for PBXProject "PixelPicker" */ = {
+		B3B4C2B81E25894B009F8E4E /* Build configuration list for PBXProject "Pixel Picker" */ = {
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				B3B4C2C81E25894B009F8E4E /* Debug */,
@@ -603,7 +618,7 @@
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;
 		};
-		B3B4C2CA1E25894B009F8E4E /* Build configuration list for PBXNativeTarget "PixelPicker" */ = {
+		B3B4C2CA1E25894B009F8E4E /* Build configuration list for PBXNativeTarget "Pixel Picker" */ = {
 			isa = XCConfigurationList;
 			buildConfigurations = (
 				B3B4C2CB1E25894B009F8E4E /* Debug */,
@@ -2,6 +2,6 @@
 <Workspace
   version = "1.0">
   <FileRef
-      location = "self:/Users/cosmotherly/dev/pixel-picker/PixelPicker.xcodeproj">
+      location = "self:/Users/cosmotherly/src/pixel-picker/Pixel Picker.xcodeproj">
   </FileRef>
 </Workspace>
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>
@@ -15,9 +15,9 @@
            <BuildableReference
               BuildableIdentifier = "primary"
               BlueprintIdentifier = "B3B4C2BC1E25894B009F8E4E"
-               BuildableName = "PixelPicker.app"
-               BlueprintName = "PixelPicker"
-               ReferencedContainer = "container:PixelPicker.xcodeproj">
+               BuildableName = "Pixel Picker.app"
+               BlueprintName = "Pixel Picker"
+               ReferencedContainer = "container:Pixel Picker.xcodeproj">
            </BuildableReference>
         </BuildActionEntry>
      </BuildActionEntries>
@@ -34,9 +34,9 @@
            <BuildableReference
               BuildableIdentifier = "primary"
               BlueprintIdentifier = "15B4E86F207994AF0024FDE4"
-               BuildableName = "PixelPickerTests.xctest"
-               BlueprintName = "PixelPickerTests"
-               ReferencedContainer = "container:PixelPicker.xcodeproj">
+               BuildableName = "Pixel PickerTests.xctest"
+               BlueprintName = "Pixel PickerTests"
+               ReferencedContainer = "container:Pixel Picker.xcodeproj">
            </BuildableReference>
         </TestableReference>
      </Testables>
@@ -44,9 +44,9 @@
         <BuildableReference
            BuildableIdentifier = "primary"
            BlueprintIdentifier = "B3B4C2BC1E25894B009F8E4E"
-            BuildableName = "PixelPicker.app"
-            BlueprintName = "PixelPicker"
-            ReferencedContainer = "container:PixelPicker.xcodeproj">
+            BuildableName = "Pixel Picker.app"
+            BlueprintName = "Pixel Picker"
+            ReferencedContainer = "container:Pixel Picker.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
      <EnvironmentVariables>
@@ -79,9 +79,9 @@
         <BuildableReference
            BuildableIdentifier = "primary"
            BlueprintIdentifier = "B3B4C2BC1E25894B009F8E4E"
-            BuildableName = "PixelPicker.app"
-            BlueprintName = "PixelPicker"
-            ReferencedContainer = "container:PixelPicker.xcodeproj">
+            BuildableName = "Pixel Picker.app"
+            BlueprintName = "Pixel Picker"
+            ReferencedContainer = "container:Pixel Picker.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
      <AdditionalOptions>
@@ -98,9 +98,9 @@
         <BuildableReference
            BuildableIdentifier = "primary"
            BlueprintIdentifier = "B3B4C2BC1E25894B009F8E4E"
-            BuildableName = "PixelPicker.app"
-            BlueprintName = "PixelPicker"
-            ReferencedContainer = "container:PixelPicker.xcodeproj">
+            BuildableName = "Pixel Picker.app"
+            BlueprintName = "Pixel Picker"
+            ReferencedContainer = "container:Pixel Picker.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
   </ProfileAction>
@@ -0,0 +1,333 @@
+//
+//  AppDelegate+Menu.swift
+//  Pixel Picker
+//
+
+/**
+ * This file is responsible for managing PixelPicker's dropdown menu when
+ * the user clicks on the status bar item.
+ */
+
+import LaunchAtLogin
+
+// The settings available for displaying a grid in the picker's preview.
+enum GridSetting {
+    case never, always, inFocusMode
+    static let withNames: [(String, GridSetting)] = [
+        ("Only in Focus Mode", .inFocusMode),
+        ("Always", .always),
+        ("Never", .never)
+    ]
+}
+
+// The modifiers available to use to toggle "focusMode".
+let focusModifiers: [(String, NSEvent.ModifierFlags)] = [
+    ("fn Function", .function),
+    ("⌘ Command", .command),
+    ("⌃ Control", .control),
+    ("⌥ Option", .option),
+    ("⇧ Shift ", .shift)
+]
+
+// The available status item images that the user may pick from.
+let statusItemImages: [(String, String)] =  [
+    ("Magnifying Glass (Default)", "icon-default"),
+    ("Palette", "icon-palette"),
+    ("Dropper", "icon-dropper"),
+    ("Magnifying Glass Dropper", "icon-mag-dropper"),
+    ("Magnifying Glass Dropper Flat", "icon-mag-dropper-flat")
+]
+
+extension AppDelegate: NSMenuDelegate {
+    // Unregister the activating shortcut when the menu is opened/closed so it can't be called when
+    // setting a new shortcut. Also start a run loop observer so we know when the modifierFlags have
+    // changed (used to dynamically update the menu).
+    func menuWillOpen(_ menu: NSMenu) {
+        unregisterActivatingShortcut()
+        if runLoopObserver == nil {
+            let activites = CFRunLoopActivity.beforeWaiting.rawValue
+            runLoopObserver = CFRunLoopObserverCreateWithHandler(nil, activites, true, 0, { [unowned self] (_, _) in
+                self.updateMenuItems()
+            })
+            CFRunLoopAddObserver(CFRunLoopGetCurrent(), runLoopObserver, CFRunLoopMode.commonModes)
+        }
+    }
+
+    // Re-register the activating shortcut, and remove the run loop observer.
+    func menuDidClose(_ menu: NSMenu) {
+        registerActivatingShortcut()
+        if (runLoopObserver != nil) {
+            CFRunLoopObserverInvalidate(runLoopObserver)
+            runLoopObserver = nil
+        }
+    }
+
+    // Updates the titles of the recently picked colors - if the `option` key is pressed, then
+    // the colors will be in the format they were *when* they were picked, otherwise they'll be
+    // in the currently chosen format.
+    private func updateMenuItems() {
+        // Update recent picks list with correct titles.
+        let alternate = NSEvent.modifierFlags.contains(.option)
+        for item in contextMenu.items {
+            if let pickedColor = item.representedObject as? PPPickedColor {
+                item.title = alternate
+                    ? pickedColor.asString
+                    : PPState.shared.chosenFormat.asString(withColor: pickedColor.color)
+            }
+        }
+    }
+
+    // This rebuilds the context menu from scratch. For the sake of simplicity, we re-create the
+    // menu from scratch each time. It's not an expensive operation, and is only called when the
+    // user opens the menu.
+    func rebuildContextMenu() {
+        contextMenu.removeAllItems()
+
+        let pickItem = contextMenu.addItem(withTitle: "Pick a pixel!", action: #selector(showPicker), keyEquivalent: "")
+        pickItem.image = PPState.shared.statusItemImage(withName: PPState.shared.statusItemImageName)
+
+        buildRecentPicks()
+
+        contextMenu.addItem(.separator())
+        buildAppIconMenu()
+        buildShowGridMenu()
+        buildColorSpaceItem()
+        buildColorFormatsMenu()
+        buildMagnificationMenu()
+        buildFocusModeModifierMenu()
+        buildFloatPrecisionSlider()
+        buildShortcutMenuItem()
+        buildUseUppercaseItem()
+        buildLaunchAtLoginItem()
+
+        contextMenu.addItem(.separator())
+        contextMenu.addItem(withTitle: "About", action: #selector(showAboutPanel), keyEquivalent: "")
+        contextMenu.addItem(withTitle: "Quit \(APP_NAME)", action: #selector(quitApplication), keyEquivalent: "")
+    }
+
+    // Choose the status item icon.
+    private func buildAppIconMenu() {
+        let submenu = NSMenu()
+        for (name, imageName) in statusItemImages {
+            let item = submenu.addItem(withTitle: name, action: #selector(selectAppIcon(_:)), keyEquivalent: "")
+            item.representedObject = imageName
+            item.state = PPState.shared.statusItemImageName == imageName ? .on : .off
+            item.image = PPState.shared.statusItemImage(withName: imageName)
+        }
+
+        let item = contextMenu.addItem(withTitle: "App Icon", action: nil, keyEquivalent: "")
+        item.submenu = submenu
+    }
+
+    @objc private func selectAppIcon(_ sender: NSMenuItem) {
+        if let imageName = sender.representedObject as? String {
+            menuBarItem.image = PPState.shared.statusItemImage(withName: imageName)
+            PPState.shared.statusItemImageName = imageName
+        }
+    }
+
+    // Choose whether to always draw a grid, never draw one, or only draw one when in focus mode.
+    private func buildShowGridMenu() {
+        let submenu = NSMenu()
+        for (title, setting) in GridSetting.withNames {
+            let item = submenu.addItem(withTitle: title, action: #selector(selectGridSetting(_:)), keyEquivalent: "")
+            item.representedObject = setting
+            item.state = PPState.shared.gridSetting == setting ? .on : .off
+        }
+
+        let item = contextMenu.addItem(withTitle: "Show Grid", action: nil, keyEquivalent: "")
+        item.submenu = submenu
+    }
+
+    @objc private func selectGridSetting(_ sender: NSMenuItem) {
+        if let setting = sender.representedObject as? GridSetting {
+            PPState.shared.gridSetting = setting
+        }
+    }
+
+    // A menu that allows choosing what color space the picker will use.
+    private func buildColorSpaceItem() {
+        let submenu = NSMenu()
+
+        let defaultItem = submenu.addItem(withTitle: "Default (infer from screen)", action: #selector(setColorSpace(_:)), keyEquivalent: "")
+        defaultItem.state = PPState.shared.colorSpace == nil ? .on : .off
+        submenu.addItem(.separator())
+        for (title, name) in PPColor.colorSpaceNames {
+            let item = submenu.addItem(withTitle: title, action: #selector(setColorSpace(_:)), keyEquivalent: "")
+            item.representedObject = name
+            item.state = PPState.shared.colorSpace == name ? .on : .off
+        }
+
+        let item = contextMenu.addItem(withTitle: "Color Space", action: nil, keyEquivalent: "")
+        item.submenu = submenu
+    }
+
+    // If the selected color space is nil, then the preview will just infer the color space from
+    // the screen the picker is currently on.
+    @objc private func setColorSpace(_ sender: NSMenuItem) {
+        PPState.shared.colorSpace = sender.representedObject as? String
+    }
+
+    // A menu which allows the magnification level of the picker to be adjusted.
+    private func buildMagnificationMenu() {
+        let submenu = NSMenu()
+        for i in stride(from: 4, through: 24, by: 2) {
+            let item = submenu.addItem(withTitle: "\(i)x", action: #selector(selectMagnification(_:)), keyEquivalent: "")
+            item.representedObject = i
+            item.state = PPState.shared.magnificationLevel == i ? .on : .off
+        }
+        let item = contextMenu.addItem(withTitle: "Magnification", action: nil, keyEquivalent: "")
+        item.submenu = submenu
+    }
+
+    @objc private func selectMagnification(_ sender: NSMenuItem) {
+        if let level = sender.representedObject as? Int {
+            PPState.shared.magnificationLevel = level
+        }
+    }
+
+    // Format hex colors to uppercase.
+    private func buildUseUppercaseItem() {
+        let item = contextMenu.addItem(withTitle: "Uppercase Hex Digits", action: #selector(setUseUppercase(_:)), keyEquivalent: "")
+        item.state = PPState.shared.useUppercase ? .on : .off
+    }
+
+    @objc private func setUseUppercase(_ sender: NSMenuItem) {
+        PPState.shared.useUppercase = sender.state != .on
+    }
+
+    // Simple launch app at login menu item.
+    private func buildLaunchAtLoginItem() {
+        let item = contextMenu.addItem(withTitle: "Launch \(APP_NAME) at Login", action: #selector(launchAtLogin(_:)), keyEquivalent: "")
+        item.state = LaunchAtLogin.isEnabled ? .on : .off
+    }
+
+    @objc private func launchAtLogin(_ sender: NSMenuItem) {
+        LaunchAtLogin.isEnabled = !LaunchAtLogin.isEnabled
+    }
+
+    // Show the user's recent picks in the menu.
+    private func buildRecentPicks() {
+        if PPState.shared.recentPicks.count > 0 {
+            contextMenu.addItem(.separator())
+            contextMenu.addItem(withTitle: "Recently Picked", action: nil, keyEquivalent: "")
+            let format = PPState.shared.chosenFormat
+            for pickedColor in PPState.shared.recentPicks.reversed() {
+                let item = contextMenu.addItem(withTitle: format.asString(withColor: pickedColor.color), action: #selector(copyRecentPick(_:)), keyEquivalent: "")
+                item.representedObject = pickedColor
+                item.image = circleImage(withSize: 12, color: pickedColor.color)
+            }
+        }
+    }
+
+    // Copies the recently picked color (associated with the menu item) to the clipboard.
+    // If the `option` key is pressed, then it copies the color in the same format it was
+    // when it was picked (otherwise, it copies it in the currently chosen format).
+    @objc private func copyRecentPick(_ sender: NSMenuItem) {
+        if let pickedColor = sender.representedObject as? PPPickedColor {
+            let value = NSEvent.modifierFlags.contains(.option)
+                ? pickedColor.asString
+                : PPState.shared.chosenFormat.asString(withColor: pickedColor.color)
+            copyToPasteboard(stringValue: value)
+        }
+    }
+
+    // Simply creates a circle NSImage with the given size and color.
+    private func circleImage(withSize size: CGFloat, color: NSColor) -> NSImage {
+        let image = NSImage(size: NSSize(width: size, height: size))
+        image.lockFocus()
+        color.set()
+        NSBezierPath(roundedRect: NSMakeRect(0, 0, size, size), xRadius: size, yRadius: size).fill()
+        image.unlockFocus()
+        return image
+    }
+
+    // A slider to change the float precision.
+    private func buildFloatPrecisionSlider() {
+        contextMenu.addItem(withTitle: "Float Precision (\(PPState.shared.floatPrecision))", action: nil, keyEquivalent: "")
+
+        let value = Double(PPState.shared.floatPrecision)
+        let maxValue = Double(PPState.maxFloatPrecision)
+        let slider = NSSlider(value: value, minValue: 1, maxValue: maxValue, target: self, action: #selector(sliderUpdate(_:)))
+        slider.allowsTickMarkValuesOnly = true
+        slider.autoresizingMask = .width
+        slider.tickMarkPosition = .above
+        slider.numberOfTickMarks = PPState.maxFloatPrecision
+        slider.frame = slider.frame.insetBy(dx: 20, dy: 0)
+
+        let item = contextMenu.addItem(withTitle: "Slider", action: nil, keyEquivalent: "")
+        item.view = NSView(frame: NSMakeRect(0, 0, 100, 20))
+        item.view!.autoresizingMask = .width
+        item.view!.addSubview(slider)
+    }
+
+    // Called when the slider is updated.
+    @objc private func sliderUpdate(_ sender: NSSlider) {
+        let newValue = UInt(sender.intValue)
+
+        // Update slider title.
+        if let item = contextMenu.item(withTitle: "Float Precision (\(PPState.shared.floatPrecision))") {
+            item.title = "Float Precision (\(newValue))"
+        }
+
+        // Update state.
+        PPState.shared.floatPrecision = newValue
+
+        // Update recent picks list with new precision.
+        updateMenuItems()
+    }
+
+    // Build a submenu with each case in the PPColor enum.
+    private func buildColorFormatsMenu() {
+        let submenu = NSMenu()
+        for format in PPColor.allCases {
+            let formatItem = submenu.addItem(withTitle: format.rawValue, action: #selector(selectFormat(_:)), keyEquivalent: "")
+            formatItem.representedObject = format
+            if PPState.shared.chosenFormat == format { formatItem.state = .on }
+        }
+
+        let item = contextMenu.addItem(withTitle: "Color Format", action: nil, keyEquivalent: "")
+        item.submenu = submenu
+    }
+
+    // Set the selected format as the default.
+    @objc private func selectFormat(_ sender: NSMenuItem) {
+        if let format = sender.representedObject as? PPColor {
+            PPState.shared.chosenFormat = format
+        }
+    }
+
+    // Builds and adds the focus modifier submenu.
+    private func buildFocusModeModifierMenu() {
+        let submenu = NSMenu()
+        for (name, modifier) in focusModifiers {
+            let modifierItem = submenu.addItem(withTitle: name, action: #selector(selectModifier(_:)), keyEquivalent: "")
+            modifierItem.representedObject = modifier
+            if PPState.shared.focusModeModifier == modifier { modifierItem.state = .on }
+        }
+
+        let item = contextMenu.addItem(withTitle: "Focus Mode Modifier", action: nil, keyEquivalent: "")
+        item.submenu = submenu
+    }
+
+    // Set the chosen modifier to toggle "focusMode".
+    @objc private func selectModifier(_ sender: NSMenuItem) {
+        if let modifier = sender.representedObject as? NSEvent.ModifierFlags {
+            PPState.shared.focusModeModifier = modifier
+        }
+    }
+
+    // Builds and adds the MASShortcutView to be used in the menu.
+    // Uses a custom view to handle events correctly (since it's inside a NSMenu).
+    private func buildShortcutMenuItem() {
+        contextMenu.addItem(withTitle: "Picker Shortcut", action: nil, keyEquivalent: "")
+
+        let shortcutView = MASShortcutView()
+        shortcutView.style = .flat
+        shortcutView.shortcutValue = PPState.shared.activatingShortcut
+        shortcutView.shortcutValueChange = { PPState.shared.activatingShortcut = $0?.shortcutValue }
+
+        let item = contextMenu.addItem(withTitle: "Shortcut", action: nil, keyEquivalent: "")
+        item.view = PPMenuShortcutView(shortcut: shortcutView)
+    }
+}
@@ -1,31 +1,34 @@
 //
 //  AppDelegate.swift
-//  PixelPicker
+//  Pixel Picker
 //

 import MASShortcut
 import CleanroomLogger

-// The app's menu bar item.
-let ICON = setupMenuBarIcon(NSImage(named: NSImage.Name(rawValue: "icon")))
-
@NSApplicationMain class AppDelegate: NSObject, NSApplicationDelegate {

    // This controller manages the pixel picker itself.
    @IBOutlet weak var overlayController: PPOverlayController!
-    
-    var contextMenu: NSMenu = NSMenu()
+
+    // The actual menu bar item.
    var menuBarItem: NSStatusItem! = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
-    
+    // The menu that drops down from the menu bar item.
+    var contextMenu: NSMenu = NSMenu()
+    // When the menu bar is opened, we observe the run loop for changes in modifierFlags.
+    var runLoopObserver: CFRunLoopObserver? = nil
+
    // Setup logging and load state.
    func applicationWillFinishLaunching(_ notification: Notification) {
        let minimumSeverity: LogSeverity = PPState.shared.defaults.bool(forKey: "debugMode") ? .debug : .info
        var logConfigurations: [LogConfiguration] = [
            RotatingLogFileConfiguration(minimumSeverity: minimumSeverity, daysToKeep: 7, directoryPath: defaultLogPath().path)
        ]
+
        #if DEBUG
        logConfigurations.append(XcodeLogConfiguration(minimumSeverity: .debug))
        #endif
+
        Log.enable(configuration: logConfigurations)
        PPState.shared.loadFromDisk()
    }
@@ -34,25 +37,31 @@ let ICON = setupMenuBarIcon(NSImage(named: NSImage.Name(rawValue: "icon")))
    func applicationDidFinishLaunching(_ aNotification: Notification) {
        contextMenu.delegate = self

-        menuBarItem.image = ICON
+        menuBarItem.image = PPState.shared.statusItemImage(withName: PPState.shared.statusItemImageName)
        menuBarItem.action = #selector(onMenuClick)
        menuBarItem.sendAction(on: [.leftMouseUp, .rightMouseUp])
-        
+
        registerActivatingShortcut()

+        // Set the CGEventSource.localEventsSuppressionInterval to a small interval (default: 250ms)
+        // otherwise there'll be a delay when we re-associate the mouse input with the mouse cursor
+        // (in the picker) that makes it feel laggy (the suppression interval controls how long
+        // hardware events are suppressed after functions like CGWarpMouseCursorPosition are used.
+        CGEventSource(stateID: CGEventSourceStateID.combinedSessionState)?.localEventsSuppressionInterval = 0.05
+
        Log.info?.message("Sucessfully launched.")
    }

    func applicationWillTerminate(_ aNotification: Notification) {
        PPState.shared.saveToDisk()
    }
-    
+
    func registerActivatingShortcut() {
        if let shortcut = PPState.shared.activatingShortcut {
            MASShortcutMonitor.shared().register(shortcut, withAction: showPicker)
        }
    }
-    
+
    func unregisterActivatingShortcut() {
        MASShortcutMonitor.shared().unregisterShortcut(PPState.shared.activatingShortcut)
    }
@@ -61,7 +70,7 @@ let ICON = setupMenuBarIcon(NSImage(named: NSImage.Name(rawValue: "icon")))
        let leftClickToggles = PPState.shared.defaults.bool(forKey: "leftClickActivates")
        let pickerEvent: NSEvent.EventType = leftClickToggles ? .leftMouseUp : .rightMouseUp
        let dropdownEvent: NSEvent.EventType = leftClickToggles ? .rightMouseUp : .leftMouseUp
-        
+
        let event = NSApp.currentEvent!
        if event.type == dropdownEvent {
            rebuildContextMenu()
@@ -70,7 +79,7 @@ let ICON = setupMenuBarIcon(NSImage(named: NSImage.Name(rawValue: "icon")))
            showPicker()
        }
    }
-    
+
    @objc func showPicker() {
        overlayController.showPicker()
    }
@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "idiom" : "universal",
+      "filename" : "dropper.png",
+      "scale" : "1x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "dropper-1.png",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "dropper-2.png",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}
@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "idiom" : "universal",
+      "filename" : "mag_dropper_flat.png",
+      "scale" : "1x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "mag_dropper_flat-1.png",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "mag_dropper_flat-2.png",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}
@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "idiom" : "universal",
+      "filename" : "mag_dropper.png",
+      "scale" : "1x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "mag_dropper-1.png",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "mag_dropper-2.png",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}
@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "idiom" : "universal",
+      "filename" : "palette.png",
+      "scale" : "1x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "palette-1.png",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "palette-2.png",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}
@@ -1,6 +1,6 @@
 //
 //  Bridging-Header.h
-//  PixelPicker
+//  Pixel Picker
 //

 #ifndef Bridging_Header_h
@@ -0,0 +1,61 @@
+//
+//  CGImage.swift
+//  Pixel Picker
+//
+
+import CleanroomLogger
+
+extension CGImage {
+    // In order to get the color at a given pixel from a CGImage, we need to convert the CGImage's
+    // data to a bitmap and draw it. We do so via a CGContext, and then manually extract the data at
+    // the desired pixel.
+    func colorAt(x: Int, y: Int) -> NSColor {
+        assert(0 <= x && x < self.width)
+        assert(0 <= y && y < self.height)
+
+        let bitmapBytesPerRow = width * 4
+        let bitmapByteCount = bitmapBytesPerRow * Int(self.height)
+
+        // Allocate memory for image data. This is the destination in memory where any drawing to
+        // the bitmap context will be rendered.
+        let bitmapInfo = CGBitmapInfo(rawValue: CGImageAlphaInfo.premultipliedFirst.rawValue)
+        let bitmapData = malloc(bitmapByteCount)
+
+        // Since we manually allocate memeory for the data, we must ensure that the same memory is
+        // freed after we've used it.
+        defer { free(bitmapData) }
+
+        // Create the bitmap context.
+        let context = CGContext(
+            data: bitmapData,
+            width: self.width,
+            height: self.height,
+            bitsPerComponent: 8,
+            bytesPerRow: bitmapBytesPerRow,
+            space: CGColorSpaceCreateDeviceRGB(),
+            bitmapInfo: bitmapInfo.rawValue
+        )
+
+        // Extract the pixel data from the right offset.
+        if context != nil {
+            // First, we draw the image data onto the context we created.
+            let rect = CGRect(x: 0, y: 0, width: self.width, height: self.height)
+            context!.draw(self, in: rect)
+
+            // Then we extract the data at the right spot.
+            let data = context!.data!
+            let offset = 4 * (y * width + x)
+
+            let a = CGFloat(data.load(fromByteOffset: offset,     as: UInt8.self)) / 255.0
+            let r = CGFloat(data.load(fromByteOffset: offset + 1, as: UInt8.self)) / 255.0
+            let g = CGFloat(data.load(fromByteOffset: offset + 2, as: UInt8.self)) / 255.0
+            let b = CGFloat(data.load(fromByteOffset: offset + 3, as: UInt8.self)) / 255.0
+            return NSColor(red: r, green: g, blue: b, alpha: a)
+        }
+
+        // Creating the context failed, so return a default color instead.
+        // Hopefully, this should never happen.
+        Log.error?.message("Failed to create CGContext!")
+        return NSColor.black
+    }
+}
@@ -1,6 +1,6 @@
-{\rtf1\ansi\ansicpg1252\cocoartf1561\cocoasubrtf400
-{\fonttbl\f0\fswiss\fcharset0 ArialMT;\f1\fnil\fcharset0 AppleColorEmoji;\f2\fmodern\fcharset0 Courier;
-}
+{\rtf1\ansi\ansicpg1252\cocoartf1671\cocoasubrtf200
+{\fonttbl\f0\fswiss\fcharset0 ArialMT;\f1\fnil\fcharset0 AppleColorEmoji;\f2\fswiss\fcharset0 Arial-BoldMT;
+\f3\fswiss\fcharset0 Arial-ItalicMT;\f4\fmodern\fcharset0 Courier;}
 {\colortbl;\red255\green255\blue255;\red0\green0\blue0;\red230\green230\blue230;}
 {\*\expandedcolortbl;;\cssrgb\c0\c0\c0;\csgray\c92143;}
 \paperw12240\paperh15840\margl1440\margr1440\vieww12800\viewh10340\viewkind0
@@ -16,8 +16,8 @@
 \f0 \
 \

-\b\fs28 PixelPicker makes use of the following open source libraries
-\b0\fs26\fsmilli13333 \
+\f2\b\fs28 Pixel Picker makes use of the following open source libraries
+\f0\b0\fs26\fsmilli13333 \
 \pard\pardeftab720\qc\partightenfactor0
 {\field{\*\fldinst{HYPERLINK "https://github.com/emaloney/CleanroomLogger"}}{\fldrslt \cf2 CleanroomLogger}}\
 \pard\pardeftab720\qc\partightenfactor0
@@ -27,37 +27,38 @@
 \pard\pardeftab720\qc\partightenfactor0
 {\field{\*\fldinst{HYPERLINK "https://github.com/SwiftyJSON/SwiftyJSON"}}{\fldrslt \cf2 SwiftyJSON}}\
 \
-
-\b\fs36 Experimental Overrides
-\b0 \
 \pard\pardeftab720\qc\partightenfactor0

-\fs26\fsmilli13333 \cf2 These are experimental options that haven't made it into PixelPickers's UI yet, and may be toggled via the Terminal. Each override is listed as 
-\b key: 
-\i\b0 type
-\i0  which you can enable like:\
+\f2\b\fs36 \cf2 Experimental Overrides
+\f0\b0 \
 \pard\pardeftab720\qc\partightenfactor0

-\f2\fs20 \cf2 \cb3 defaults write com.acheronfail.pixel-picker debugMode -bool true
+\fs26\fsmilli13333 \cf2 These are experimental options that haven't made it into Pixel Pickers's UI yet, and may be toggled via the Terminal. Each override is listed as 
+\f2\b key: 
+\f3\i\b0 type
+\f0\i0  which you can enable like:\
+\pard\pardeftab720\qc\partightenfactor0
+
+\f4\fs20 \cf2 \cb3 defaults write com.acheronfail.pixel-picker debugMode -bool true
 \f0\fs26\fsmilli13333 \cb1 \
 \
 \pard\pardeftab720\qc\partightenfactor0

-\b \cf0 \kerning1\expnd0\expndtw0 leftClickActivates
-\b0 \cf2 \expnd0\expndtw0\kerning0
+\f2\b \cf0 \kerning1\expnd0\expndtw0 leftClickActivates
+\f0\b0 \cf2 \expnd0\expndtw0\kerning0
 : 
-\i \cf0 \kerning1\expnd0\expndtw0 Bool = false\
+\f3\i \cf0 \kerning1\expnd0\expndtw0 Bool = false\
 \pard\pardeftab720\qc\partightenfactor0

-\i0 \cf2 \expnd0\expndtw0\kerning0
+\f0\i0 \cf2 \expnd0\expndtw0\kerning0
 Swaps the left and right click buttons when clicking on the menu bar icon. So left-clicking will activate the picker, and right-clicking will open the dropdown menu.\
 \
 \pard\pardeftab720\qc\partightenfactor0

-\b \cf0 \kerning1\expnd0\expndtw0 debugMode
-\b0 \cf2 \expnd0\expndtw0\kerning0
+\f2\b \cf0 \kerning1\expnd0\expndtw0 debugMode
+\f0\b0 \cf2 \expnd0\expndtw0\kerning0
 : 
-\i \cf0 \kerning1\expnd0\expndtw0 Bool = false
-\i0 \cf2 \expnd0\expndtw0\kerning0
+\f3\i \cf0 \kerning1\expnd0\expndtw0 Bool = false
+\f0\i0 \cf2 \expnd0\expndtw0\kerning0
 \
-Set this to true to enable debug logging. This results in a higher level of logs being written to ~/Library/Preferences/PixelPicker/logs/.}
+Set this to true to enable debug logging. This results in a higher level of logs being written to ~/Library/Preferences/Pixel Picker/logs/.}
@@ -17,9 +17,9 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0.0</string>
+	<string>1.3.6</string>
 	<key>CFBundleVersion</key>
-	<string>1</string>
+	<string>16</string>
 	<key>LSApplicationCategoryType</key>
 	<string>public.app-category.utilities</string>
 	<key>LSMinimumSystemVersion</key>
@@ -0,0 +1,22 @@
+//
+//  NSBezierPath.swift
+//  Pixel Picker
+//
+
+// Extend NSBezierPath to allow easy conversion to a CGPath.
+// https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/CocoaDrawingGuide/Paths/Paths.html#//apple_ref/doc/uid/TP40003290-CH206-SW2
+extension NSBezierPath {
+    var cgPath: CGPath {
+        let path = CGMutablePath()
+        var points = [CGPoint](repeating: .zero, count: 3)
+        for i in 0 ..< self.elementCount {
+            switch self.element(at: i, associatedPoints: &points) {
+            case .moveTo: path.move(to: points[0])
+            case .lineTo: path.addLine(to: points[0])
+            case .curveTo: path.addCurve(to: points[2], control1: points[0], control2: points[1])
+            case .closePath: path.closeSubpath()
+            }
+        }
+        return path
+    }
+}
@@ -1,6 +1,6 @@
 //
 //  NSColor.swift
-//  PixelPicker
+//  Pixel Picker
 //

 import SwiftyJSON
@@ -26,6 +26,16 @@ extension NSColor {
        return nil
    }

+    // Creates an NSImage with the given size and color.
+    func image(withSize size: NSSize) -> NSImage {
+        let image = NSImage(size: size)
+        image.lockFocus()
+        self.set()
+        NSRect(origin: NSPoint.zero, size: size).fill()
+        image.unlockFocus()
+        return image
+    }
+
    // Returns either black or white, whichever will contrast the most with the given color.
    // See https://stackoverflow.com/a/3943023/5552584
    func bestContrastingColor() -> NSColor {
@@ -1,6 +1,6 @@
 //
 //  PPOverlayController.swift
-//  PixelPicker
+//  Pixel Picker
 //

 import CleanroomLogger
@@ -15,29 +15,28 @@ class PPOverlayController: NSWindowController {

    // Outlets relating to the picker's info box.
    @IBOutlet weak var infoPanel: PPOverlayPanel!
-    @IBOutlet weak var infoBox: NSBox!
+    @IBOutlet weak var infoWrapper: NSView!
    @IBOutlet weak var infoFormatField: NSTextField!
    @IBOutlet weak var infoDetailField: NSTextField!

-    // The current magnification level of the preview.
-    // TODO: make this somewhat configurable?
-    var magnification: CGFloat = 8.0
-
-    // This mode increases the picker's size, increases the magnification and also
-    // slows down mouseMove events to make it easier to pick the right pixel.
-    var concentrationMode: Bool = false {
+    // This mode increases the picker's size, increases the magnification and also slows down move
+    // events to make it easier to pick the right pixel. We dissociate the mouse (input) from the
+    // mouse cursor while the focusMode is active. This is so we can slow it down.
+    var focusMode: Bool = false {
        didSet {
            if isEnabled {
-                panelSize = concentrationMode ? 300 : 150
+                panelSize = focusMode ? PPOverlayController.panelSizeLarge : PPOverlayController.panelSizeNormal
                overlayPanel.activate(withSize: panelSize, infoPanel: infoPanel)
                wrapper.layer?.cornerRadius = PPState.shared.paschaModeEnabled ? 0 : panelSize / 2
+                CGAssociateMouseAndMouseCursorPosition(boolean_t(truncating: focusMode ? 0 : 1))
            }
        }
    }

-    // The size of the pixel picker.
-    // TODO: use constants rather than hard-coded values.
-    private var panelSize: CGFloat = 150
+    // The current and different sizes of the pixel picker.
+    private static let panelSizeNormal: CGFloat = 150
+    private static let panelSizeLarge: CGFloat = 300
+    private var panelSize: CGFloat = PPOverlayController.panelSizeNormal

    // The app that was last active before the picker was activated. We keep track
    // of this in order to fully restore first responder status after picking a pixel.
@@ -50,23 +49,24 @@ class PPOverlayController: NSWindowController {
    private var lastHighlightedColor: NSColor = NSColor.black

    // Whether or not the picker should be actively updating its preview.
-    // We dissociate the mouse (input) from the mouse cursor while the picker is active.
-    // This is so we can slow down the mouse movement during concentration mode.
    private var isEnabled: Bool = false {
        didSet {
            if isEnabled {
                lastMouseLocation = NSEvent.mouseLocation
                startMonitoringEvents()
-                CGAssociateMouseAndMouseCursorPosition(boolean_t(truncating: 0))
            } else {
                stopMonitoringEvents()
-                concentrationMode = false
-                CGAssociateMouseAndMouseCursorPosition(boolean_t(truncating: 1))
+                focusMode = false
            }
        }
    }

    override func awakeFromNib() {
+        // Setup the info window.
+        infoWrapper.wantsLayer = true
+        infoWrapper.layer?.cornerRadius = 8
+        infoWrapper.layer?.backgroundColor = NSColor.black.cgColor
+
        // For some reason if we don't listen for events this way we miss the escape key.
        NSEvent.addLocalMonitorForEvents(matching: [.keyDown]) {
            if self.isEnabled { self.keyDown(with: $0) }
@@ -90,57 +90,78 @@ class PPOverlayController: NSWindowController {
    // When the user clicks, animate the cursor out, save the picked color and copy it.
    override func mouseDown(with event: NSEvent) {
        hidePicker(animate: true)
-
-        let pickedColor = PPPickedColor(color: lastHighlightedColor, format: PPState.shared.chosenFormat)
-        PPState.shared.addRecentPick(pickedColor)
-        copyToPasteboard(stringValue: pickedColor.asString)
+        pickColor()
    }

-    // Close picker immediately when the user presses the escape key.
+    // Listen to key events.
    override func keyDown(with event: NSEvent) {
-        if event.keyCode == kVK_Escape { hidePicker(animate: false) }
-        if event.keyCode == kVK_Space {
-            let format = PPState.shared.chosenFormat
-            PPState.shared.chosenFormat = event.modifierFlags.contains(.shift) ? format.previous() : format.next()
+        switch Int(event.keyCode) {
+        // Close immediately on escape.
+        case kVK_Escape:
+            hidePicker(animate: false)
+        // Act as if the user clicked on space.
+        case kVK_Space:
+            hidePicker(animate: true)
+            pickColor()
+        // Cycle between formats when the user presses the left or right arrow keys.
+        case kVK_LeftArrow:
+            PPState.shared.chosenFormat = PPState.shared.chosenFormat.previous()
            updateInfoPanel(lastHighlightedColor, lastHighlightedColor.bestContrastingColor())
+        case kVK_RightArrow:
+            PPState.shared.chosenFormat = PPState.shared.chosenFormat.next()
+            updateInfoPanel(lastHighlightedColor, lastHighlightedColor.bestContrastingColor())
+        default:
+            break
        }
    }

-    // Enable "concentrationMode" when correct modifier flag is changed.
+    // Enable "focusMode" when correct modifier flag is changed.
    override func flagsChanged(with event: NSEvent) {
        if isEnabled {
-            concentrationMode = event.modifierFlags.contains(PPState.shared.concentrationModeModifier)
+            focusMode = event.modifierFlags.contains(PPState.shared.focusModeModifier)
            updatePreview(aroundPoint: lastMouseLocation)
        }
    }

-    // Move the picker with the mouse, and if "concentrationMode" is active then
+    // Move the picker with the mouse, and if "focusMode" is active then
    // slow it down to make it easier to pick the correct pixel.
    override func mouseMoved(with event: NSEvent) {
        if isEnabled {
-            let speed: CGFloat = concentrationMode ? 0.1 : 0.5
            let currentMouseLocation = NSEvent.mouseLocation
+            var nextMouseLocation = currentMouseLocation

-            let x = lastMouseLocation.x + (event.deltaX * speed)
-            let y = lastMouseLocation.y - (event.deltaY * speed)
+            // Slow down tracking speed when focusMode is active.
+            if focusMode {
+                let speed: CGFloat = focusMode ? 0.1 : 0.5
+                let x = lastMouseLocation.x + (event.deltaX * speed)
+                let y = lastMouseLocation.y - (event.deltaY * speed)

-            // Ensure the picker doesn't travel off screen.
-            var nextMouseLocation = NSPoint(x: x, y: y)
-            for screen in NSScreen.screens {
-                let outsideCoordinate = coordinateOutsideRect(nextMouseLocation, screen.frame)
-                if NSMouseInRect(currentMouseLocation, screen.frame, false) && outsideCoordinate != .none {
-                    if outsideCoordinate == .x { nextMouseLocation.x = currentMouseLocation.x }
-                    if outsideCoordinate == .y { nextMouseLocation.y = currentMouseLocation.y }
-                    if outsideCoordinate == .both { nextMouseLocation = currentMouseLocation }
+                // Ensure the picker doesn't travel off screen.
+                nextMouseLocation = NSPoint(x: x, y: y)
+                for screen in NSScreen.screens {
+                    let outlier = Coordinate.isOutsideRect(nextMouseLocation, screen.frame)
+                    if NSMouseInRect(currentMouseLocation, screen.frame, false) && outlier != .none {
+                        if outlier == .x { nextMouseLocation.x = currentMouseLocation.x }
+                        if outlier == .y { nextMouseLocation.y = currentMouseLocation.y }
+                        if outlier == .both { nextMouseLocation = currentMouseLocation }
+                    }
                }
+
+                // Since we've disassociated the mouse input with the cursor, we manually move it.
+                CGWarpMouseCursorPosition(convertToCGCoordinateSystem(nextMouseLocation))
            }

-            CGWarpMouseCursorPosition(convertToCGCoordinateSystem(nextMouseLocation))
            updatePreview(aroundPoint: nextMouseLocation)
            lastMouseLocation = nextMouseLocation
        }
    }

+    func pickColor() {
+        let pickedColor = PPPickedColor(color: lastHighlightedColor, format: PPState.shared.chosenFormat)
+        PPState.shared.addRecentPick(pickedColor)
+        copyToPasteboard(stringValue: pickedColor.asString)
+    }
+
    // Show the picker, save the previously active application, and hide the cursor.
    func showPicker() {
        if overlayPanel.isVisible || infoPanel.isVisible { return }
@@ -209,7 +230,7 @@ class PPOverlayController: NSWindowController {

    // Updates the info panel with the correct colors and text.
    func updateInfoPanel(_ color: NSColor, _ contrastingColor: NSColor) {
-        infoBox.fillColor = color.alphaComponent == 0 ? NSColor.black : color
+        infoWrapper.layer?.backgroundColor = color.cgColor
        infoFormatField.textColor = contrastingColor
        infoDetailField.textColor = contrastingColor
        infoFormatField.stringValue = PPState.shared.chosenFormat.rawValue
@@ -230,12 +251,20 @@ class PPOverlayController: NSWindowController {
        // Ensure the overlayPanel is always the key window.
        if !overlayPanel.isKeyWindow {
            overlayPanel.activate(withSize: panelSize, infoPanel: infoPanel)
+            // Reset the cursor state to ensure it's hidden (the foremost application changes then
+            // WindowServer resets our "SetsCursorInBackground" magic).
+            ShowCursor()
+            HideCursor()
        }

+        // Center the mouse in the picker window.
+        overlayPanel.setFrameOrigin(NSPoint(x: point.x - (panelSize / 2), y: point.y - (panelSize / 2)))
        let normalisedPoint = NSPoint(x: round(point.x * 2) / 2, y: round(point.y * 2) / 2)
        if let screenShot = getScreenShot(aroundPoint: normalisedPoint) {
+
            // Calculate a zoomed rect which will crop the screenshot we took.
-            let zoomReciprocal: CGFloat = 1.0 / (concentrationMode ? magnification * 2.5 : magnification)
+            let magnification = CGFloat(PPState.shared.magnificationLevel)
+            let zoomReciprocal: CGFloat = 1.0 / (focusMode ? magnification * 2.5 : magnification)
            let currentSize = CGFloat(screenShot.width) + 1
            let origin = floor(currentSize * ((1 - zoomReciprocal) / 2))
            let x = origin + (isHalf(normalisedPoint.x) ? 1 : 0)
@@ -243,28 +272,66 @@ class PPOverlayController: NSWindowController {

            // Ensure preview size is an odd number (so there's a middle pixel).
            let zoomedSize = floor(ensureOdd(currentSize * zoomReciprocal))
-            let middle = zoomedSize / 2
-
            let croppedRect = CGRect(x: x, y: y, width: zoomedSize, height: zoomedSize)
            let zoomedImage: CGImage = screenShot.cropping(to: croppedRect)!
+            let pixelSize = panelSize / zoomedSize

-            // Extract the middle pixel color from the zoomed image.
-            let bitmap = NSBitmapImageRep(cgImage: zoomedImage)
-            bitmap.colorSpaceName = .calibratedRGB
-            if let colorAtPixel = bitmap.colorAt(x: Int(middle), y: Int(middle)) {
-                let contrastingColor = colorAtPixel.bestContrastingColor()
+            // Convert the preview to the correct color space, and update the overlay.

-                preview.layer?.contents = NSImage(cgImage: zoomedImage, size: NSSize(width: panelSize, height: panelSize))
-                preview.updateCrosshair(panelSize / zoomedSize, middle, contrastingColor.cgColor)
-                wrapper.update(contrastingColor.cgColor)
-                updateInfoPanel(colorAtPixel, contrastingColor)
-
-                // Save color under pixel (used when copied).
-                lastHighlightedColor = colorAtPixel
+            // User has chosen a custom color space.
+            if let colorSpace = getChosenColorSpace(point) {
+                if colorSpace == zoomedImage.colorSpace {
+                    return updatePreview(zoomedImage, pixelSize, zoomedSize)
+                } else if let image = zoomedImage.copy(colorSpace: colorSpace) {
+                    return updatePreview(image, pixelSize, zoomedSize)
+                }
            }
+
+            // No custom color space chosen, so use the screen's one.
+            if let colorSpace = getScreenColorSpace(point) {
+                if colorSpace == zoomedImage.colorSpace {
+                    return updatePreview(zoomedImage, pixelSize, zoomedSize)
+                } else if let image = zoomedImage.copy(colorSpace: colorSpace) {
+                    return updatePreview(image, pixelSize, zoomedSize)
+                }
+            }
+
+            // If that also didn't work, then just return the image in its default color space.
+            return updatePreview(zoomedImage, pixelSize, zoomedSize)
+        }
+    }
+
+    private func updatePreview(_ image: CGImage, _ pixelSize: CGFloat, _ numberOfPixels: CGFloat) {
+        let middlePosition = numberOfPixels / 2
+
+        // Extract the middle pixel color from the prepared image.
+        let colorAtPixel = image.colorAt(x: Int(middlePosition), y: Int(middlePosition))
+        let contrastingColor = colorAtPixel.bestContrastingColor()
+
+        // Update picker border and info panel.
+        wrapper.update(contrastingColor.cgColor)
+        updateInfoPanel(colorAtPixel, contrastingColor)
+
+        // Update the picker preview.
+        preview.layer?.contents = image
+        preview.updateCrosshair(pixelSize, middlePosition, contrastingColor.cgColor)
+        let showGrid = PPState.shared.gridSetting == .always || (focusMode && PPState.shared.gridSetting == .inFocusMode)
+        preview.updateGrid(cellSize: pixelSize, numberOfCells: Int(numberOfPixels), shouldDisplay: showGrid)
+
+        // Save color under pixel (used when copied).
+        lastHighlightedColor = colorAtPixel
+    }
+
+    private func getScreenColorSpace(_ point: NSPoint) -> CGColorSpace? {
+        return getScreenFromPoint(point)?.colorSpace?.cgColorSpace
+    }
+
+    // Gets the colorspace in which to display the preview and retreive color values.
+    private func getChosenColorSpace(_ point: NSPoint) -> CGColorSpace? {
+        if let name = PPState.shared.colorSpace, let colorSpace = CGColorSpace(name: name as CFString) {
+            return colorSpace
        }

-        // Center the mouse in the picker window.
-        overlayPanel.setFrameOrigin(NSPoint(x: normalisedPoint.x - (panelSize / 2), y: normalisedPoint.y - (panelSize / 2)))
+        return nil
    }
 }
@@ -3,7 +3,6 @@
    <dependencies>
        <deployment identifier="macosx"/>
        <plugIn identifier="com.apple.InterfaceBuilder.CocoaPlugin" version="14109"/>
-        <capability name="box content view" minToolsVersion="7.0"/>
        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
    </dependencies>
    <objects>
@@ -21,10 +20,10 @@
        </customObject>
        <customObject id="ECQ-9M-Pkg" customClass="PPOverlayController" customModule="PixelPicker" customModuleProvider="target">
            <connections>
-                <outlet property="infoBox" destination="rpe-Xh-gaO" id="BYW-qP-HLd"/>
                <outlet property="infoDetailField" destination="Re2-GH-fyd" id="K03-75-cf9"/>
                <outlet property="infoFormatField" destination="1fa-UE-yMM" id="Nan-fO-kbu"/>
                <outlet property="infoPanel" destination="OMO-LB-w57" id="GGj-Y6-LfU"/>
+                <outlet property="infoWrapper" destination="HED-rR-FDP" id="21H-Tc-c4W"/>
                <outlet property="overlayPanel" destination="gZA-A3-IZ5" id="DUd-MU-oD4"/>
                <outlet property="preview" destination="oj3-ml-2qo" id="xLc-pu-U90"/>
                <outlet property="window" destination="gZA-A3-IZ5" id="GLv-sO-WxM"/>
@@ -35,7 +34,7 @@
            <windowStyleMask key="styleMask" utility="YES" nonactivatingPanel="YES"/>
            <windowPositionMask key="initialPositionMask" leftStrut="YES" rightStrut="YES" topStrut="YES" bottomStrut="YES"/>
            <rect key="contentRect" x="196" y="132" width="101" height="101"/>
-            <rect key="screenRect" x="0.0" y="0.0" width="1920" height="1178"/>
+            <rect key="screenRect" x="0.0" y="0.0" width="1680" height="1028"/>
            <view key="contentView" id="acW-WA-gq2" customClass="PPOverlayWrapper" customModule="PixelPicker" customModuleProvider="target">
                <rect key="frame" x="0.0" y="0.0" width="101" height="101"/>
                <autoresizingMask key="autoresizingMask"/>
@@ -56,50 +55,35 @@
        <window title="Window" allowsToolTipsWhenApplicationIsInactive="NO" autorecalculatesKeyViewLoop="NO" restorable="NO" oneShot="NO" showsToolbarButton="NO" visibleAtLaunch="NO" frameAutosaveName="" animationBehavior="default" id="OMO-LB-w57" customClass="PPOverlayPanel" customModule="PixelPicker" customModuleProvider="target">
            <windowStyleMask key="styleMask" utility="YES" nonactivatingPanel="YES"/>
            <rect key="contentRect" x="926" y="538" width="100" height="50"/>
-            <rect key="screenRect" x="0.0" y="0.0" width="1920" height="1178"/>
+            <rect key="screenRect" x="0.0" y="0.0" width="1680" height="1028"/>
            <view key="contentView" id="HED-rR-FDP">
                <rect key="frame" x="0.0" y="0.0" width="100" height="50"/>
                <autoresizingMask key="autoresizingMask"/>
                <subviews>
-                    <box boxType="custom" borderType="none" cornerRadius="4" title="Box" translatesAutoresizingMaskIntoConstraints="NO" id="rpe-Xh-gaO">
-                        <rect key="frame" x="0.0" y="0.0" width="100" height="50"/>
-                        <view key="contentView" id="g1f-dN-SYl">
-                            <rect key="frame" x="0.0" y="0.0" width="100" height="50"/>
-                            <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
-                            <subviews>
-                                <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" translatesAutoresizingMaskIntoConstraints="NO" id="1fa-UE-yMM">
-                                    <rect key="frame" x="-2" y="28" width="104" height="17"/>
-                                    <textFieldCell key="cell" scrollable="YES" lineBreakMode="clipping" sendsActionOnEndEditing="YES" alignment="center" title="Label" id="RkG-Wy-Shq">
-                                        <font key="font" metaFont="system"/>
-                                        <color key="textColor" name="labelColor" catalog="System" colorSpace="catalog"/>
-                                        <color key="backgroundColor" name="controlColor" catalog="System" colorSpace="catalog"/>
-                                    </textFieldCell>
-                                </textField>
-                                <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" translatesAutoresizingMaskIntoConstraints="NO" id="Re2-GH-fyd">
-                                    <rect key="frame" x="-2" y="5" width="104" height="14"/>
-                                    <textFieldCell key="cell" scrollable="YES" lineBreakMode="clipping" sendsActionOnEndEditing="YES" alignment="center" title="Label" id="IYd-1Y-7cd">
-                                        <font key="font" metaFont="smallSystem"/>
-                                        <color key="textColor" name="labelColor" catalog="System" colorSpace="catalog"/>
-                                        <color key="backgroundColor" name="controlColor" catalog="System" colorSpace="catalog"/>
-                                    </textFieldCell>
-                                </textField>
-                            </subviews>
-                            <constraints>
-                                <constraint firstItem="1fa-UE-yMM" firstAttribute="top" secondItem="g1f-dN-SYl" secondAttribute="top" constant="5" id="OMX-Uf-gxc"/>
-                                <constraint firstAttribute="trailing" secondItem="1fa-UE-yMM" secondAttribute="trailing" id="YWA-wF-wWD"/>
-                                <constraint firstItem="Re2-GH-fyd" firstAttribute="leading" secondItem="g1f-dN-SYl" secondAttribute="leading" id="def-Ev-ONx"/>
-                                <constraint firstItem="1fa-UE-yMM" firstAttribute="leading" secondItem="g1f-dN-SYl" secondAttribute="leading" id="j0J-F5-ipt"/>
-                                <constraint firstAttribute="bottom" secondItem="Re2-GH-fyd" secondAttribute="bottom" constant="5" id="ktF-UW-gVI"/>
-                                <constraint firstAttribute="trailing" secondItem="Re2-GH-fyd" secondAttribute="trailing" id="t9s-4R-bFb"/>
-                            </constraints>
-                        </view>
-                    </box>
+                    <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" translatesAutoresizingMaskIntoConstraints="NO" id="1fa-UE-yMM">
+                        <rect key="frame" x="-2" y="25" width="104" height="17"/>
+                        <textFieldCell key="cell" scrollable="YES" lineBreakMode="clipping" sendsActionOnEndEditing="YES" alignment="center" title="Label" id="RkG-Wy-Shq">
+                            <font key="font" metaFont="system"/>
+                            <color key="textColor" name="labelColor" catalog="System" colorSpace="catalog"/>
+                            <color key="backgroundColor" name="controlColor" catalog="System" colorSpace="catalog"/>
+                        </textFieldCell>
+                    </textField>
+                    <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" translatesAutoresizingMaskIntoConstraints="NO" id="Re2-GH-fyd">
+                        <rect key="frame" x="-2" y="8" width="104" height="14"/>
+                        <textFieldCell key="cell" scrollable="YES" lineBreakMode="clipping" sendsActionOnEndEditing="YES" alignment="center" title="Label" id="IYd-1Y-7cd">
+                            <font key="font" metaFont="smallSystem"/>
+                            <color key="textColor" name="labelColor" catalog="System" colorSpace="catalog"/>
+                            <color key="backgroundColor" name="controlColor" catalog="System" colorSpace="catalog"/>
+                        </textFieldCell>
+                    </textField>
                </subviews>
                <constraints>
-                    <constraint firstItem="rpe-Xh-gaO" firstAttribute="leading" secondItem="HED-rR-FDP" secondAttribute="leading" id="Buc-en-Way"/>
-                    <constraint firstItem="rpe-Xh-gaO" firstAttribute="top" secondItem="HED-rR-FDP" secondAttribute="top" id="NrK-e2-suw"/>
-                    <constraint firstAttribute="bottom" secondItem="rpe-Xh-gaO" secondAttribute="bottom" id="WSu-Ro-a4K"/>
-                    <constraint firstAttribute="trailing" secondItem="rpe-Xh-gaO" secondAttribute="trailing" id="myM-UI-QfA"/>
+                    <constraint firstItem="1fa-UE-yMM" firstAttribute="leading" secondItem="HED-rR-FDP" secondAttribute="leading" id="23z-pW-nAx"/>
+                    <constraint firstItem="1fa-UE-yMM" firstAttribute="top" secondItem="HED-rR-FDP" secondAttribute="top" constant="8" id="G1j-j5-iWY"/>
+                    <constraint firstItem="Re2-GH-fyd" firstAttribute="leading" secondItem="HED-rR-FDP" secondAttribute="leading" id="aZf-QY-Lpd"/>
+                    <constraint firstAttribute="bottom" secondItem="Re2-GH-fyd" secondAttribute="bottom" constant="8" id="amm-jV-oWa"/>
+                    <constraint firstAttribute="trailing" secondItem="1fa-UE-yMM" secondAttribute="trailing" id="flM-Te-2qj"/>
+                    <constraint firstAttribute="trailing" secondItem="Re2-GH-fyd" secondAttribute="trailing" id="jWO-5f-uxW"/>
                </constraints>
            </view>
            <point key="canvasLocation" x="236" y="230"/>
@@ -1,6 +1,6 @@
 //
 //  PPOverlayPanel.swift
-//  PixelPicker
+//  Pixel Picker
 //

 // This class is in charge of managing the panels which are brought to the front
@@ -0,0 +1,74 @@
+//
+//  PPOverlayPreview.swift
+//  Pixel Picker
+//
+
+// This class is in charge of rendering the pixel preview.
+class PPOverlayPreview: NSView, CALayerDelegate {
+    // A grid that's optionally shown in the preview.
+    private var grid: CAShapeLayer = CAShapeLayer()
+    private var lastCellSize: CGFloat?
+    private var lastNumberOfCells: Int?
+
+    // The small pixel-box in the centre of the picker.
+    var crosshair: CAShapeLayer = CAShapeLayer()
+    
+    override var wantsUpdateLayer: Bool {
+        get { return true }
+    }
+
+    override func awakeFromNib() {
+        // Make layers contents resize to fill, and disable antialiasing.
+        wantsLayer = true
+        layer?.magnificationFilter = .nearest
+        layer?.contentsGravity = .resizeAspectFill
+        layer?.delegate = self
+
+        // Add the grid shape layers to the view.
+        grid.strokeColor = NSColor.gray.cgColor
+        grid.fillColor = nil
+        layer?.addSublayer(grid)
+
+        // Prepare crosshair shape layers.
+        crosshair.strokeColor = NSColor.black.cgColor
+        crosshair.fillColor = nil
+        layer?.addSublayer(crosshair)
+    }
+
+    // Update the crosshair with the correct color, position and size.
+    func updateCrosshair(_ pixelSize: CGFloat, _ middle: CGFloat, _ color: CGColor) {
+        let pos: CGFloat = (pixelSize * middle) - (pixelSize / 2) + 0.5
+        let pixelRect = NSMakeRect(pos, pos, pixelSize, pixelSize)
+        
+        crosshair.path = CGPath(rect: pixelRect, transform: nil)
+        crosshair.strokeColor = color
+        setNeedsDisplay(pixelRect)
+    }
+
+    // Redraws the grid in the preview.
+    func updateGrid(cellSize size: CGFloat, numberOfCells n: Int, shouldDisplay: Bool) {
+        // Disable implicit animations within this transaction.
+        CATransaction.setDisableActions(true)
+        grid.opacity = shouldDisplay ? 0.25 : 0
+
+        // Only redraw the grid if we need to display it and the dimensions have changed since last
+        // the last time we drew it.
+        guard shouldDisplay && (size != lastCellSize || n != lastNumberOfCells) else { return }
+        lastCellSize = size
+        lastNumberOfCells = n
+
+        let path = NSBezierPath()
+        let start = CGFloat(0) + 0.5
+        let end = CGFloat(n) * size + 0.5
+
+        for i in 1..<n {
+            let pos = CGFloat(i) * size + 0.5
+            path.move(to: NSPoint(x: pos, y: start))
+            path.line(to: NSPoint(x: pos, y: end))
+            path.move(to: NSPoint(x: start, y: pos))
+            path.line(to: NSPoint(x: end, y: pos))
+        }
+
+        grid.path = path.cgPath
+    }
+}
@@ -1,6 +1,6 @@
 //
 //  PPOverlayWrapper.swift
-//  PixelPicker
+//  Pixel Picker
 //

 // This class is basically the content view of the overlay panel.
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
acheronfail	8c0a82c2f0	version: 1.3.6	2019-05-29 14:29:58 +10:00
acheronfail	124c1cc145	chore: carthage update --platform macos	2019-05-29 14:29:39 +10:00
acheronfail	02b4beacb3	version: 1.3.5	2019-05-29 14:25:36 +10:00
acheronfail	8495bcde33	Merge pull request #22 from viktorstrate/fix-grid-offset Move crosshair and grid by 0.5 pixels	2019-05-29 14:23:53 +10:00
viktorstrate	32d8f24286	Move crosshair and grid by 0.5 pixels To perfectly align it between the pixels	2019-05-28 15:47:46 +02:00
acheronfail	f843510abe	version: 1.3.4	2019-03-04 10:42:15 +11:00
acheronfail	1e4d9f1f07	fix: swift uicolor formatters were producing nscolor strings fixes #20	2019-03-04 10:30:35 +11:00
acheronfail	54af9202ab	version: 1.3.3	2019-02-21 22:22:31 +11:00
acheronfail	d9d0aa8211	fix: issues with development signing	2019-02-20 12:35:43 +11:00
acheronfail	5ebfac1d01	version: 1.3.2	2019-02-20 07:21:14 +11:00
acheronfail	6e400d191f	chore: rename from "PixelPicker" to "Pixel Picker"	2019-02-20 07:21:03 +11:00
acheronfail	5ad66714fc	chore: update README.md	2019-02-19 14:18:50 +11:00
acheronfail	061f29c887	version: 1.3.1	2019-02-19 09:49:26 +11:00
acheronfail	dde01f357d	chore: carthage update and codesign application	2019-02-19 09:43:09 +11:00
acheronfail	b445e0517f	chore: use an entirely legit method to call some pointers	2019-02-19 09:01:16 +11:00
acheronfail	da82de17b4	version: 1.3.0	2019-02-18 19:23:11 +11:00
acheronfail	258b2ce35c	feat: add ability to choose different status item icons (#19 ) * feat: add ability to choose different status item icons	2019-02-18 19:21:49 +11:00
acheronfail	d7d0323911	chore: re-word menu item	2019-02-18 19:17:37 +11:00
Frederik Schweiger	c0d339661c	Add Dart / Flutter support and hex uppercase option (#16 ) feat: dart/flutter support and hex uppercase option	2019-02-18 07:53:48 +11:00
acheronfail	bdffc54f6c	chore: change license from MIT to GPLv3	2018-11-03 09:24:05 +11:00
acheronfail	222ccffb7b	chore: build against macOS 10.14 SDK	2018-11-02 15:52:58 +11:00
acheronfail	0f7f7524a7	chore: update dependencies	2018-11-02 15:52:39 +11:00
acheronfail	20192b6cb2	version 1.2.3	2018-06-06 07:17:38 +10:00
acheronfail	ec78ffb864	fix: update views to work better with new macOS interface styles	2018-06-06 07:11:12 +10:00
acheronfail	9ce676c51c	fixup: indentation	2018-06-05 22:52:36 +10:00
acheronfail	1ad62f4bf8	chore: update to Swift 4.2 - fixes #4	2018-06-05 22:51:31 +10:00
acheronfail	fee08c000b	version 1.2.2	2018-05-31 07:17:42 +10:00
acheronfail	e087df3b93	feat: space now picks color; arrow keys cycle between formats	2018-05-31 07:17:16 +10:00
acheronfail	a7d112a8ba	chore: doc updates	2018-05-30 17:28:46 +10:00
acheronfail	b4175bae13	version 1.2.1	2018-05-30 16:51:48 +10:00
acheronfail	a63fd85bc5	fix: ensure cursor is hidden even when apps change	2018-05-30 16:51:32 +10:00
acheronfail	ff1063c8e2	chore: move CGImage extension into its own file	2018-05-30 15:33:09 +10:00
acheronfail	1305e4366a	chore: refactoring code; move NSBezierPath extension to its own file	2018-05-30 15:32:51 +10:00
acheronfail	4cad88d0cd	chore: updated cursor api usage definitions	2018-05-30 15:32:44 +10:00
acheronfail	58f3ef9ecd	fix: add grid before crosshair	2018-05-26 09:07:34 +10:00
acheronfail	8b907ac7ed	tweak: reduce emoji overkill in README	2018-05-26 09:05:18 +10:00
acheronfail	e5ce05dc89	tweak: README changes	2018-05-26 02:24:23 +10:00
acheronfail	42f88bcf53	chore: update demo image - fixes #13	2018-05-26 02:16:13 +10:00
acheronfail	4ddfe5a0f3	version 1.2.0	2018-05-26 02:02:08 +10:00
acheronfail	0e60e12364	update comment	2018-05-26 02:01:52 +10:00
acheronfail	06e20d5594	feat: preview now has the option of drawing a grid	2018-05-26 01:53:43 +10:00
acheronfail	5c7e1b61d7	version 1.1.0	2018-05-25 11:39:33 +10:00
acheronfail	57da81bc29	feat: support for colorspaces; improvements to color extraction; This commit adds support for color spaces - now the app should display the exact colors of the pixels on your screen. If you'd like to use other color spaces, those can be chosen from within the app's menu. This also improves the calculation logic for retrieving the correct values from an NSColor (before the fence-post error was returning very very slightly incorrect values). Since colors on macOS are represented as Float values, there's only so much precision we can have. We also now use a custom bitmap context to extract the color from the CGImage, this is to ensure the color we extract is in the correct color space. Fixes #12	2018-05-25 11:37:27 +10:00
acheronfail	86c4b29ed5	fix: sometimes hex values would be shorter than 6 characters	2018-05-23 22:06:48 +10:00
acheronfail	88f3465f27	fix: preview crosshair now wraps the center pixel better	2018-05-22 19:37:50 +10:00
acheronfail	27d4ca0d3b	version 1.0.2	2018-05-22 19:04:50 +10:00
acheronfail	2802953130	updated demo image	2018-05-22 19:04:29 +10:00
acheronfail	5087a973cf	reversed the order of recent picks in the menu	2018-05-22 19:02:07 +10:00
acheronfail	a6e85ec913	update banner	2018-05-22 18:42:20 +10:00
acheronfail	27b3b9768c	updated icon	2018-05-22 15:32:35 +10:00
acheronfail	c26eb28536	version 1.0.1	2018-05-22 15:13:53 +10:00
acheronfail	9330644f9e	improvements to cursor tracking and handling - fixes #9	2018-05-22 15:13:53 +10:00
acheronfail	e672053594	add configurable magnification levels - fixes #6	2018-05-22 15:13:53 +10:00
acheronfail	ef3ddda8e6	dynamically update the menu when option is pressed - fixes #3	2018-05-21 13:43:08 +10:00
acheronfail	b734282b0d	xcode project updates	2018-05-20 21:34:54 +10:00
acheronfail	a343b50916	refactor screen bounds checking	2018-05-20 17:26:57 +10:00
acheronfail	40866ce9f8	minor change in screen bounds checking	2018-05-20 17:25:32 +10:00
acheronfail	ffeedffda9	update README	2018-05-20 17:13:31 +10:00
acheronfail	46159dd5d4	removed useless framework file	2018-05-20 17:12:08 +10:00