Merge pull request #103 from mattpolzin/add-include12-include13

Add Include12 and Include13 types.

Author: mattpolzin

.github/workflows/tests.yml

@@ -28,6 +28,14 @@ jobs:
           - swift:5.4-focal
           - swift:5.4-centos8
           - swift:5.4-amazonlinux2
+          - swift:5.5-xenial
+          - swift:5.5-bionic
+          - swift:5.5-focal
+          - swift:5.5-centos8
+          - swift:5.5-amazonlinux2
+          - swift:5.6-bionic
+          - swift:5.6-focal
+          - swift:5.6-amazonlinux2
     container: ${{ matrix.image }}
     steps:
     - name: Checkout code

JSONAPI.podspec

@@ -16,7 +16,7 @@ Pod::Spec.new do |spec|
   #
 
   spec.name         = "MP-JSONAPI"
-  spec.version      = "5.0.2"
+  spec.version      = "5.1.0"
   spec.summary      = "Swift Codable JSON API framework."
 
   # This description is used to generate tags and improve search results.
@@ -136,6 +136,6 @@ See the JSON API Spec here: https://jsonapi.org/format/
   # spec.requires_arc = true
 
   # spec.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }
-  spec.dependency "Poly", "~> 2.4"
+  spec.dependency "Poly", "~> 2.6"
 
 end

Package.resolved

@@ -17,7 +17,7 @@ let package = Package(
             targets: ["JSONAPITesting"])
     ],
     dependencies: [
-        .package(url: "https://github.com/mattpolzin/Poly.git", .upToNextMajor(from: "2.4.0")),
+        .package(url: "https://github.com/mattpolzin/Poly.git", .upToNextMajor(from: "2.6.0")),
     ],
     targets: [
         .target(

Package.swift

@@ -66,7 +66,7 @@ If you find something wrong with this library and it isn't already mentioned und
 ### Swift Package Manager
 Just include the following in your package's dependencies and add `JSONAPI` to the dependencies for any of your targets.
 ```swift
-.package(url: "https://github.com/mattpolzin/JSONAPI.git", from: "5.0.2")
+.package(url: "https://github.com/mattpolzin/JSONAPI.git", from: "5.1.0")
 ```
 
 ### Xcode project

README.md

@@ -71,7 +71,7 @@ extension Sequence where Element: CompoundResourceProtocol {
     }
 }
 
-extension EncodableJSONAPIDocument where PrimaryResourceBody: EncodableResourceBody, PrimaryResourceBody.PrimaryResource: ResourceObjectType {
+extension EncodableJSONAPIDocument where PrimaryResourceBody.PrimaryResource: ResourceObjectType {
     public typealias CompoundResource = JSONAPI.CompoundResource<PrimaryResourceBody.PrimaryResource, IncludeType>
 }
 

Sources/JSONAPI/Document/CompoundResource.swift

@@ -33,6 +33,10 @@ public enum DocumentDecodingError: Swift.Error, Equatable {
             self = .primaryResourceMissing
         case .valueNotFound(let type, let context) where Location(context) == .data && type == UnkeyedDecodingContainer.self:
             self = .primaryResourcesMissing
+        case .typeMismatch(let type, let context) where Location(context) == .data && type is _ArrayType.Type && context.debugDescription.hasSuffix("but found null instead."):
+            self = .primaryResourcesMissing
+        case .typeMismatch(_, let context) where Location(context) == .data && context.debugDescription.hasSuffix("but found null instead."):
+            self = .primaryResourceMissing
         default:
             return nil
         }
@@ -71,3 +75,6 @@ extension DocumentDecodingError: CustomStringConvertible {
         }
     }
 }
+
+private protocol _ArrayType {}
+extension Array: _ArrayType {}

Sources/JSONAPI/Document/DocumentDecodingError.swift

@@ -206,6 +206,22 @@ extension Includes where I: _Poly11 {
     }
 }
 
+// MARK: - 12 includes
+public typealias Include12 = Poly12
+extension Includes where I: _Poly12 {
+    public subscript(_ lookup: I.L.Type) -> [I.L] {
+        return values.compactMap(\.l)
+    }
+}
+
+// MARK: - 13 includes
+public typealias Include13 = Poly13
+extension Includes where I: _Poly13 {
+    public subscript(_ lookup: I.M.Type) -> [I.M] {
+        return values.compactMap(\.m)
+    }
+}
+
 // MARK: - DecodingError
 public struct IncludesDecodingError: Swift.Error, Equatable {
     public let error: Swift.Error

Sources/JSONAPI/Document/Includes.swift

@@ -162,3 +162,67 @@ extension Poly11: CodablePrimaryResource, OptionalCodablePrimaryResource
         I: CodablePolyWrapped,
         J: CodablePolyWrapped,
         K: CodablePolyWrapped {}
+
+// MARK: - 12 types
+extension Poly12: EncodablePrimaryResource, OptionalEncodablePrimaryResource
+where
+A: EncodablePolyWrapped,
+B: EncodablePolyWrapped,
+C: EncodablePolyWrapped,
+D: EncodablePolyWrapped,
+E: EncodablePolyWrapped,
+F: EncodablePolyWrapped,
+G: EncodablePolyWrapped,
+H: EncodablePolyWrapped,
+I: EncodablePolyWrapped,
+J: EncodablePolyWrapped,
+K: EncodablePolyWrapped,
+L: EncodablePolyWrapped {}
+
+extension Poly12: CodablePrimaryResource, OptionalCodablePrimaryResource
+where
+A: CodablePolyWrapped,
+B: CodablePolyWrapped,
+C: CodablePolyWrapped,
+D: CodablePolyWrapped,
+E: CodablePolyWrapped,
+F: CodablePolyWrapped,
+G: CodablePolyWrapped,
+H: CodablePolyWrapped,
+I: CodablePolyWrapped,
+J: CodablePolyWrapped,
+K: CodablePolyWrapped,
+L: CodablePolyWrapped {}
+
+// MARK: - 13 types
+extension Poly13: EncodablePrimaryResource, OptionalEncodablePrimaryResource
+where
+A: EncodablePolyWrapped,
+B: EncodablePolyWrapped,
+C: EncodablePolyWrapped,
+D: EncodablePolyWrapped,
+E: EncodablePolyWrapped,
+F: EncodablePolyWrapped,
+G: EncodablePolyWrapped,
+H: EncodablePolyWrapped,
+I: EncodablePolyWrapped,
+J: EncodablePolyWrapped,
+K: EncodablePolyWrapped,
+L: EncodablePolyWrapped,
+M: EncodablePolyWrapped {}
+
+extension Poly13: CodablePrimaryResource, OptionalCodablePrimaryResource
+where
+A: CodablePolyWrapped,
+B: CodablePolyWrapped,
+C: CodablePolyWrapped,
+D: CodablePolyWrapped,
+E: CodablePolyWrapped,
+F: CodablePolyWrapped,
+G: CodablePolyWrapped,
+H: CodablePolyWrapped,
+I: CodablePolyWrapped,
+J: CodablePolyWrapped,
+K: CodablePolyWrapped,
+L: CodablePolyWrapped,
+M: CodablePolyWrapped {}

Sources/JSONAPI/Resource/Poly+PrimaryResource.swift

@@ -117,9 +117,16 @@ public struct ResourceObjectDecodingError: Swift.Error, Equatable {
             location = .type
         }
 
+        let subjectPath: [CodingKey]
+        if location == .relationships && path.last?.stringValue == "data" {
+            subjectPath =  path.dropLast()
+        } else {
+            subjectPath = path
+        }
+
         return (
             location,
-            name: path.last?.stringValue ?? "unnamed"
+            name: subjectPath.last?.stringValue ?? "unnamed"
         )
     }
 }
@@ -130,15 +137,15 @@ extension ResourceObjectDecodingError: CustomStringConvertible {
         case .keyNotFound where subjectName == ResourceObjectDecodingError.entireObject:
             return "\(location) object is required and missing."
         case .keyNotFound where location == .type:
-            return "'type' (a.k.a. JSON:API type name) is required and missing."
+            return "'type' (a.k.a. the JSON:API type name) is required and missing."
         case .keyNotFound where location == .relationshipType:
             return "'\(subjectName)' relationship does not have a 'type'."
         case .keyNotFound where location == .relationshipId:
             return "'\(subjectName)' relationship does not have an 'id'."
         case .keyNotFound:
             return "'\(subjectName)' \(location.singular) is required and missing."
         case .valueNotFound where location == .type:
-            return "'\(location.singular)' (a.k.a. JSON:API type name) is not nullable but null was found."
+            return "'\(location.singular)' (a.k.a. the JSON:API type name) is not nullable but null was found."
         case .valueNotFound:
             return "'\(subjectName)' \(location.singular) is not nullable but null was found."
         case .typeMismatch(expectedTypeName: let expected) where location == .type: