Rename JSON to Value

Argo.xcodeproj/project.pbxproj

@@ -11,7 +11,7 @@
 		4D5F6DDA1B3832C200D79B25 /* user_with_nested_name.json in Resources */ = {isa = PBXBuildFile; fileRef = 4D5F6DD81B3832C200D79B25 /* user_with_nested_name.json */; };
 		809754CB1BADF34200C409E6 /* Argo.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 809754C11BADF34100C409E6 /* Argo.framework */; };
 		809754D81BADF36D00C409E6 /* Decoded.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69E1ABC5F1300E3B0AB /* Decoded.swift */; };
-		809754D91BADF36D00C409E6 /* JSON.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* JSON.swift */; };
+		809754D91BADF36D00C409E6 /* Value.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* Value.swift */; };
 		809754DA1BADF36D00C409E6 /* Decodable.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB6A01ABC5F1300E3B0AB /* Decodable.swift */; };
 		809754DB1BADF36D00C409E6 /* StandardTypes.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB6A11ABC5F1300E3B0AB /* StandardTypes.swift */; };
 		809754DC1BADF36D00C409E6 /* DecodeError.swift in Sources */ = {isa = PBXBuildFile; fileRef = F84318A71B9A2D7A00165216 /* DecodeError.swift */; };
@@ -59,7 +59,7 @@
 		8097550A1BADF3F200C409E6 /* types.plist in Resources */ = {isa = PBXBuildFile; fileRef = EABDF68E1A9CD4EA00B6CC83 /* types.plist */; };
 		BF92789D1B9365900038A7E1 /* RawRepresentable.swift in Sources */ = {isa = PBXBuildFile; fileRef = BF92789C1B9365900038A7E1 /* RawRepresentable.swift */; };
 		D0592EBE1B77DD8E00EFEF39 /* Decoded.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69E1ABC5F1300E3B0AB /* Decoded.swift */; };
-		D0592EBF1B77DD8E00EFEF39 /* JSON.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* JSON.swift */; };
+		D0592EBF1B77DD8E00EFEF39 /* Value.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* Value.swift */; };
 		D0592EC01B77DD8E00EFEF39 /* Decodable.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB6A01ABC5F1300E3B0AB /* Decodable.swift */; };
 		D0592EC11B77DD8E00EFEF39 /* StandardTypes.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB6A11ABC5F1300E3B0AB /* StandardTypes.swift */; };
 		D0592EC51B77DD9A00EFEF39 /* decode.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69A1ABC5F1300E3B0AB /* decode.swift */; };
@@ -160,6 +160,10 @@
 		F862E0AE1A519D5C0093B028 /* types_fail_embedded.json in Resources */ = {isa = PBXBuildFile; fileRef = EA4EAF7219DD96330036AE0D /* types_fail_embedded.json */; };
 		F874B7EA1A66BF52004CCE5E /* root_array.json in Resources */ = {isa = PBXBuildFile; fileRef = F874B7E91A66BF52004CCE5E /* root_array.json */; };
 		F874B7EB1A66C221004CCE5E /* root_array.json in Resources */ = {isa = PBXBuildFile; fileRef = F874B7E91A66BF52004CCE5E /* root_array.json */; };
+		F874DE8F1F7FFDE600D885C3 /* Deprecations.swift in Sources */ = {isa = PBXBuildFile; fileRef = F874DE8E1F7FFDE600D885C3 /* Deprecations.swift */; };
+		F874DE901F7FFDE600D885C3 /* Deprecations.swift in Sources */ = {isa = PBXBuildFile; fileRef = F874DE8E1F7FFDE600D885C3 /* Deprecations.swift */; };
+		F874DE911F7FFDE600D885C3 /* Deprecations.swift in Sources */ = {isa = PBXBuildFile; fileRef = F874DE8E1F7FFDE600D885C3 /* Deprecations.swift */; };
+		F874DE921F7FFDE600D885C3 /* Deprecations.swift in Sources */ = {isa = PBXBuildFile; fileRef = F874DE8E1F7FFDE600D885C3 /* Deprecations.swift */; };
 		F87897EF1A927864009316A5 /* Argo.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = EAD9FACF19D0EAB50031E006 /* Argo.framework */; };
 		F87EB6A41ABC5F1300E3B0AB /* decode.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69A1ABC5F1300E3B0AB /* decode.swift */; };
 		F87EB6A51ABC5F1300E3B0AB /* decode.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69A1ABC5F1300E3B0AB /* decode.swift */; };
@@ -169,8 +173,8 @@
 		F87EB6A91ABC5F1300E3B0AB /* sequence.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69C1ABC5F1300E3B0AB /* sequence.swift */; };
 		F87EB6AA1ABC5F1300E3B0AB /* Decoded.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69E1ABC5F1300E3B0AB /* Decoded.swift */; };
 		F87EB6AB1ABC5F1300E3B0AB /* Decoded.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69E1ABC5F1300E3B0AB /* Decoded.swift */; };
-		F87EB6AC1ABC5F1300E3B0AB /* JSON.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* JSON.swift */; };
-		F87EB6AD1ABC5F1300E3B0AB /* JSON.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* JSON.swift */; };
+		F87EB6AC1ABC5F1300E3B0AB /* Value.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* Value.swift */; };
+		F87EB6AD1ABC5F1300E3B0AB /* Value.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB69F1ABC5F1300E3B0AB /* Value.swift */; };
 		F87EB6AE1ABC5F1300E3B0AB /* Decodable.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB6A01ABC5F1300E3B0AB /* Decodable.swift */; };
 		F87EB6AF1ABC5F1300E3B0AB /* Decodable.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB6A01ABC5F1300E3B0AB /* Decodable.swift */; };
 		F87EB6B01ABC5F1300E3B0AB /* StandardTypes.swift in Sources */ = {isa = PBXBuildFile; fileRef = F87EB6A11ABC5F1300E3B0AB /* StandardTypes.swift */; };
@@ -329,11 +333,12 @@
 		F85F93431D42C8D6001C8EA7 /* Curry.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Curry.framework; path = Carthage/Checkouts/Curry/build/Debug/Curry.framework; sourceTree = "<group>"; };
 		F85F93451D42C8DD001C8EA7 /* Curry.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Curry.framework; path = "Carthage/Checkouts/Curry/build/Debug-appletvos/Curry.framework"; sourceTree = "<group>"; };
 		F874B7E91A66BF52004CCE5E /* root_array.json */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.json; path = root_array.json; sourceTree = "<group>"; };
+		F874DE8E1F7FFDE600D885C3 /* Deprecations.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Deprecations.swift; sourceTree = "<group>"; };
 		F87EB69A1ABC5F1300E3B0AB /* decode.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = decode.swift; sourceTree = "<group>"; };
 		F87EB69B1ABC5F1300E3B0AB /* flatReduce.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = flatReduce.swift; sourceTree = "<group>"; };
 		F87EB69C1ABC5F1300E3B0AB /* sequence.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = sequence.swift; sourceTree = "<group>"; };
 		F87EB69E1ABC5F1300E3B0AB /* Decoded.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Decoded.swift; sourceTree = "<group>"; };
-		F87EB69F1ABC5F1300E3B0AB /* JSON.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = JSON.swift; sourceTree = "<group>"; };
+		F87EB69F1ABC5F1300E3B0AB /* Value.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Value.swift; sourceTree = "<group>"; };
 		F87EB6A01ABC5F1300E3B0AB /* Decodable.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Decodable.swift; sourceTree = "<group>"; };
 		F87EB6A11ABC5F1300E3B0AB /* StandardTypes.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = StandardTypes.swift; sourceTree = "<group>"; };
 		F89335541A4CE83000B88685 /* Argo.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = Argo.framework; sourceTree = BUILT_PRODUCTS_DIR; };
@@ -469,6 +474,7 @@
 				F87EB69D1ABC5F1300E3B0AB /* Types */,
 				F87EB6981ABC5F1300E3B0AB /* Functions */,
 				F8CBE6651A6451F800316FBC /* Extensions */,
+				F874DE8E1F7FFDE600D885C3 /* Deprecations.swift */,
 			);
 			name = Argo;
 			path = Sources/Argo;
@@ -569,7 +575,7 @@
 			isa = PBXGroup;
 			children = (
 				EA04D5A81BBF43C7001DE23B /* Decoded */,
-				F87EB69F1ABC5F1300E3B0AB /* JSON.swift */,
+				F87EB69F1ABC5F1300E3B0AB /* Value.swift */,
 				F87EB6A01ABC5F1300E3B0AB /* Decodable.swift */,
 				F87EB6A11ABC5F1300E3B0AB /* StandardTypes.swift */,
 				F84318A71B9A2D7A00165216 /* DecodeError.swift */,
@@ -964,6 +970,7 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				F874DE921F7FFDE600D885C3 /* Deprecations.swift in Sources */,
 				EA9159F81BDE74E400D85292 /* Monad.swift in Sources */,
 				809754DF1BADF36D00C409E6 /* (null) in Sources */,
 				EA9159F71BDE74C700D85292 /* catDecoded.swift in Sources */,
@@ -979,7 +986,7 @@
 				EA9159FA1BDE74F300D85292 /* Applicative.swift in Sources */,
 				809754E51BADF36D00C409E6 /* Dictionary.swift in Sources */,
 				809754E61BADF36D00C409E6 /* RawRepresentable.swift in Sources */,
-				809754D91BADF36D00C409E6 /* JSON.swift in Sources */,
+				809754D91BADF36D00C409E6 /* Value.swift in Sources */,
 				F8C2561C1C3C855C00B70968 /* NSNumber.swift in Sources */,
 				EA9159FB1BDE74F800D85292 /* Alternative.swift in Sources */,
 			);
@@ -1017,6 +1024,7 @@
 			files = (
 				EA04D59B1BBF1FA4001DE23B /* Applicative.swift in Sources */,
 				D0592EC11B77DD8E00EFEF39 /* StandardTypes.swift in Sources */,
+				F874DE911F7FFDE600D885C3 /* Deprecations.swift in Sources */,
 				EA04D59F1BBF1FB9001DE23B /* Alternative.swift in Sources */,
 				D0592EC01B77DD8E00EFEF39 /* Decodable.swift in Sources */,
 				D0592EC51B77DD9A00EFEF39 /* decode.swift in Sources */,
@@ -1025,7 +1033,7 @@
 				EA04D5A31BBF2021001DE23B /* FailureCoalescing.swift in Sources */,
 				D0592EBE1B77DD8E00EFEF39 /* Decoded.swift in Sources */,
 				F84318AA1B9A2D7A00165216 /* DecodeError.swift in Sources */,
-				D0592EBF1B77DD8E00EFEF39 /* JSON.swift in Sources */,
+				D0592EBF1B77DD8E00EFEF39 /* Value.swift in Sources */,
 				F8EF43311BBC729F001886BA /* catDecoded.swift in Sources */,
 				EA1200CE1BAB621C006DDBD8 /* RawRepresentable.swift in Sources */,
 				EA04D5931BBF1F40001DE23B /* Monad.swift in Sources */,
@@ -1041,12 +1049,13 @@
 			files = (
 				F87EB6AA1ABC5F1300E3B0AB /* Decoded.swift in Sources */,
 				EA04D5991BBF1FA4001DE23B /* Applicative.swift in Sources */,
+				F874DE8F1F7FFDE600D885C3 /* Deprecations.swift in Sources */,
 				BF92789D1B9365900038A7E1 /* RawRepresentable.swift in Sources */,
 				EA04D59D1BBF1FB9001DE23B /* Alternative.swift in Sources */,
 				F87EB6AE1ABC5F1300E3B0AB /* Decodable.swift in Sources */,
 				F87EB6A41ABC5F1300E3B0AB /* decode.swift in Sources */,
 				F82D15F31C3C82730079FFB5 /* NSNumber.swift in Sources */,
-				F87EB6AC1ABC5F1300E3B0AB /* JSON.swift in Sources */,
+				F87EB6AC1ABC5F1300E3B0AB /* Value.swift in Sources */,
 				EA04D5A11BBF2021001DE23B /* FailureCoalescing.swift in Sources */,
 				F87EB6A61ABC5F1300E3B0AB /* flatReduce.swift in Sources */,
 				F87EB6A81ABC5F1300E3B0AB /* sequence.swift in Sources */,
@@ -1091,10 +1100,11 @@
 			files = (
 				F87EB6AB1ABC5F1300E3B0AB /* Decoded.swift in Sources */,
 				EA04D59A1BBF1FA4001DE23B /* Applicative.swift in Sources */,
+				F874DE901F7FFDE600D885C3 /* Deprecations.swift in Sources */,
 				F87EB6AF1ABC5F1300E3B0AB /* Decodable.swift in Sources */,
 				EA04D59E1BBF1FB9001DE23B /* Alternative.swift in Sources */,
 				F87EB6A51ABC5F1300E3B0AB /* decode.swift in Sources */,
-				F87EB6AD1ABC5F1300E3B0AB /* JSON.swift in Sources */,
+				F87EB6AD1ABC5F1300E3B0AB /* Value.swift in Sources */,
 				F8C2561A1C3C855B00B70968 /* NSNumber.swift in Sources */,
 				F87EB6A71ABC5F1300E3B0AB /* flatReduce.swift in Sources */,
 				EA04D5A21BBF2021001DE23B /* FailureCoalescing.swift in Sources */,

Documentation/Curry-Limitations.md

@@ -25,14 +25,14 @@ struct User: Decodable {
   let mediumAvatar: String
   let largeAvatar: String
 
-  static func decode(j: JSON) -> Decoded<User> {
+  static func decode(v: Value) -> Decoded<User> {
     return curry(User.init)
-      <^> j <| "id"
-      <*> j <| "name"
-      <*> j <| "bio"
-      <*> j <| "small_avatar"
-      <*> j <| "medium_avatar"
-      <*> j <| "large_avatar"
+      <^> v <| "id"
+      <*> v <| "name"
+      <*> v <| "bio"
+      <*> v <| "small_avatar"
+      <*> v <| "medium_avatar"
+      <*> v <| "large_avatar"
   }
 }
 ```
@@ -59,29 +59,29 @@ struct Avatar {
 
 Now `User.init` has 4 arguments and `Avatar.init` has 3 arguments, so we are
 within the assumed limitations of `curry`. But, it is also less clear how we
-should write `User.decode`. How can we extract the 3 avatar fields from `JSON`
+should write `User.decode`. How can we extract the 3 avatar fields from `Value`
 to build `Avatar` first, and then use that to build `User`? The key insight is
 to see that `j <| "key"` returns a `Decoded<T>` value, representing one step
 of decoding. So, we can decode a `Avatar` first using `j`, and then plug that
 directly into `curry(User.init)`:
 
 ```swift
 extension Avatar: Decodable {
-  static func decode(j: JSON) -> Decoded<Avatar> {
+  static func decode(v: Value) -> Decoded<Avatar> {
     return curry(Avatar.init)
-      <^> j <| "small_avatar"
-      <*> j <| "medium_avatar"
-      <*> j <| "large_avatar"
+      <^> v <| "small_avatar"
+      <*> v <| "medium_avatar"
+      <*> v <| "large_avatar"
   }
 }
 
 extension User: Decodable {
-  static func decode(j: JSON) -> Decoded<User> {
+  static func decode(v: Value) -> Decoded<User> {
     return curry(User.init)
-      <^> j <| "id"
-      <*> j <| "name"
-      <*> j <| "bio"
-      <*> Avatar.decode(j)
+      <^> v <| "id"
+      <*> v <| "name"
+      <*> v <| "bio"
+      <*> Avatar.decode(v)
   }
 }
 ```

Documentation/Decode-Enums.md

@@ -44,7 +44,7 @@ We can write `Decodable` for `FootRace` like so:
 
 ```swift
 extension FootRace: Decodable {
-  static func decode(j: JSON) -> Decoded<FootRace> {
+  static func decode(j: Value) -> Decoded<FootRace> {
     switch j {
 
     // First, make sure JSON is a number.

Sources/Argo/Deprecations.swift

@@ -0,0 +1,2 @@
+@available(*, deprecated, renamed: "Value")
+public typealias JSON = Value

Sources/Argo/Extensions/RawRepresentable.swift

@@ -3,13 +3,13 @@
   `String` as the raw value.
 */
 public extension Decodable where Self.DecodedType == Self, Self: RawRepresentable, Self.RawValue == String {
-  static func decode(_ json: JSON) -> Decoded<Self> {
-    switch json {
+  static func decode(_ value: Value) -> Decoded<Self> {
+    switch value {
     case let .string(s):
       return self.init(rawValue: s)
-        .map(pure) ?? .typeMismatch(expected: "rawValue for \(self)", actual: json)
+        .map(pure) ?? .typeMismatch(expected: "rawValue for \(self)", actual: value)
     default:
-      return .typeMismatch(expected: "String", actual: json)
+      return .typeMismatch(expected: "String", actual: value)
     }
   }
 }
@@ -19,13 +19,13 @@ public extension Decodable where Self.DecodedType == Self, Self: RawRepresentabl
   `Int` as the raw value.
 */
 public extension Decodable where Self.DecodedType == Self, Self: RawRepresentable, Self.RawValue == Int {
-  static func decode(_ json: JSON) -> Decoded<Self> {
-    switch json {
+  static func decode(_ value: Value) -> Decoded<Self> {
+    switch value {
     case let .number(n):
       return self.init(rawValue: n.intValue)
-        .map(pure) ?? .typeMismatch(expected: "rawValue for \(self)", actual: json)
+        .map(pure) ?? .typeMismatch(expected: "rawValue for \(self)", actual: value)
     default:
-      return .typeMismatch(expected: "Int", actual: json)
+      return .typeMismatch(expected: "Int", actual: value)
     }
   }
 }

Sources/Argo/Functions/decode.swift

@@ -22,7 +22,7 @@
   - returns: A `Decoded<T>` value where `T` is `Decodable`
 */
 public func decode<T: Decodable>(_ object: Any) -> Decoded<T> where T == T.DecodedType {
-  return T.decode(JSON(object))
+  return T.decode(Value(object))
 }
 
 /**
@@ -56,7 +56,7 @@ public func decode<T: Decodable>(_ object: Any) -> T? where T == T.DecodedType {
   Attempt to transform `Any` into a `Decodable` value using a specified
   root key.
 
-  This function attempts to extract the embedded `JSON` object from the
+  This function attempts to extract the embedded `Value` object from the
   dictionary at the specified key and transform it into a `Decodable` value.
   This works based on the type you ask for.
 
@@ -79,14 +79,14 @@ public func decode<T: Decodable>(_ object: Any) -> T? where T == T.DecodedType {
   - returns: A `Decoded<T>` value where `T` is `Decodable`
 */
 public func decode<T: Decodable>(_ dict: [String: Any], rootKey: String) -> Decoded<T> where T == T.DecodedType {
-  return JSON(dict as Any)[rootKey]
+  return Value(dict as Any)[rootKey]
 }
 
 /**
   Attempt to transform `Any` into a `Decodable` value using a specified
   root key and return an `Optional`.
 
-  This function attempts to extract the embedded `JSON` object from the
+  This function attempts to extract the embedded `Value` object from the
   dictionary at the specified key and transform it into a `Decodable` value,
   returning an `Optional`. This works based on the type you ask for.
 

Sources/Argo/Types/Decodable.swift

@@ -20,15 +20,15 @@ public protocol Decodable {
   associatedtype DecodedType = Self
 
   /**
-    Decode an object from JSON.
+    Decode an object from Value.
 
     This is the main entry point for Argo. This function declares how the
-    conforming type should be decoded from JSON. Since this is a failable
+    conforming type should be decoded from Value. Since this is a failable
     operation, we need to return a `Decoded` type from this function.
 
-    - parameter json: The `JSON` representation of this object
+    - parameter value: The `Value` representation of this object
 
     - returns: A decoded instance of the `DecodedType`
   */
-  static func decode(_ json: JSON) -> Decoded<DecodedType>
+  static func decode(_ value: Value) -> Decoded<DecodedType>
 }

Sources/Argo/Types/DecodeError.swift

@@ -3,13 +3,13 @@ public enum DecodeError: Error {
   /// The type existing at the key didn't match the type being requested.
   case typeMismatch(expected: String, actual: String)
 
-  /// The key did not exist in the JSON.
+  /// The key did not exist in the Value.
   case missingKey(String)
 
   /// A custom error case for adding explicit failure info.
   case custom(String)
 
-  /// There were multiple errors in the JSON.
+  /// There were multiple errors in the Value.
   case multiple([DecodeError])
 }