refactor: rename deserialization protocols

Author: drmohundro

README.md

@@ -325,20 +325,20 @@ Given:
 ```xml
 <root>
   <catalog>
-    <book id=\"bk101\">
+    <book id="bk101">
       <author>Gambardella, Matthew</author>
       <title>XML Developer's Guide</title>
       <genre>Computer</genre><price>44.95</price>
       <publish_date>2000-10-01</publish_date>
     </book>
-    <book id=\"bk102\">
+    <book id="bk102">
       <author>Ralls, Kim</author>
       <title>Midnight Rain</title>
       <genre>Fantasy</genre>
       <price>5.95</price>
       <publish_date>2000-12-16</publish_date>
     </book>
-    <book id=\"bk103\">
+    <book id="bk103">
       <author>Corets, Eva</author>
       <title>Maeve Ascendant</title>
       <genre>Fantasy</genre>
@@ -402,7 +402,7 @@ With the following implementation for `Date` element and attribute
 deserialization:
 
 ```swift
-extension Date: XMLElementDeserializable, XMLAttributeDeserializable {
+extension Date: XMLDeserialization {
     public static func deserialize(_ element: XMLElement) throws -> Date {
         let date = stringToDate(element.text)
 

SWXMLHash.xcodeproj/project.pbxproj

@@ -83,7 +83,7 @@ let booksXML = """
 </root>
 """
 
-struct Book: XMLIndexerDeserializable {
+struct Book: XMLObjectDeserialization {
     let title: String
     let price: Double
     let year: Int

SWXMLHashPlayground.playground/Pages/Introduction.xcplaygroundpage/Contents.swift

@@ -1,5 +1,5 @@
 //
-//  XMLIndexer.XMLIndexerDeserializable.swift
+//  XMLIndexer+XMLObjectDeserialization.swift
 //  SWXMLHash
 //
 //  Copyright (c) 2016 Maciek Grzybowskio
@@ -274,7 +274,7 @@ public extension XMLIndexer {
     - returns: the deserialized `T` value
     - throws: an XMLDeserializationError is there is a problem with deserialization
     */
-    func value<T: XMLIndexerDeserializable>() throws -> T {
+    func value<T: XMLObjectDeserialization>() throws -> T {
         switch self {
         case .element:
             let deserialized = try T.deserialize(self)
@@ -295,7 +295,7 @@ public extension XMLIndexer {
     - returns: the deserialized `T?` value
     - throws: an XMLDeserializationError is there is a problem with deserialization
     */
-    func value<T: XMLIndexerDeserializable>() throws -> T? {
+    func value<T: XMLObjectDeserialization>() throws -> T? {
         switch self {
         case .element:
             let deserialized = try T.deserialize(self)
@@ -314,7 +314,7 @@ public extension XMLIndexer {
     - returns: the deserialized `[T]` value
     - throws: an XMLDeserializationError is there is a problem with deserialization
     */
-    func value<T>() throws -> [T] where T: XMLIndexerDeserializable {
+    func value<T>() throws -> [T] where T: XMLObjectDeserialization {
         switch self {
         case .list(let elements):
             return try elements.map {
@@ -343,7 +343,7 @@ public extension XMLIndexer {
     - returns: the deserialized `[T]?` value
     - throws: an XMLDeserializationError is there is a problem with deserialization
     */
-    func value<T: XMLIndexerDeserializable>() throws -> [T]? {
+    func value<T: XMLObjectDeserialization>() throws -> [T]? {
         switch self {
         case .list(let elements):
             return try elements.map {
@@ -370,7 +370,7 @@ public extension XMLIndexer {
     - returns: the deserialized `[T?]` value
     - throws: an XMLDeserializationError is there is a problem with deserialization
     */
-    func value<T: XMLIndexerDeserializable>() throws -> [T?] {
+    func value<T: XMLObjectDeserialization>() throws -> [T?] {
         switch self {
         case .list(let elements):
             return try elements.map {

Source/Deserialization/XMLIndexer+XMLIndexerDeserializable.swift renamed to Source/Deserialization/XMLIndexer+XMLDeserialization.swift

@@ -26,15 +26,15 @@
 import Foundation
 
 /// Provides XMLIndexer deserialization / type transformation support
-public protocol XMLIndexerDeserializable {
+public protocol XMLObjectDeserialization {
     /// Method for deserializing elements from XMLIndexer
     static func deserialize(_ element: XMLIndexer) throws -> Self
     /// Method for validating elements post deserialization
     func validate() throws
 }
 
 /// Provides XMLIndexer deserialization / type transformation support
-public extension XMLIndexerDeserializable {
+public extension XMLObjectDeserialization {
     /**
     A default implementation that will throw an error if it is called
 

Source/Deserialization/XMLIndexerDeserializable.swift renamed to Source/Deserialization/XMLObjectDeserialization.swift

@@ -27,7 +27,7 @@ import Foundation
 
 /// This protocol implements both XMLAttributeDeserializable and XMLElementDeserializable meaning
 /// that it can be used to easily provide custom deserialization for your types.
-public protocol XMLDeserialization: XMLAttributeDeserializable, XMLElementDeserializable {
+public protocol XMLValueDeserialization: XMLAttributeDeserializable, XMLElementDeserializable {
     /// Method for deserializing elements from XMLElement
     static func deserialize(_ element: XMLElement) throws -> Self
 
@@ -39,7 +39,7 @@ public protocol XMLDeserialization: XMLAttributeDeserializable, XMLElementDeseri
 }
 
 /// Provides XMLAttribute deserialization / type transformation support
-public extension XMLDeserialization {
+public extension XMLValueDeserialization {
     /**
     A default implementation that will throw an error if it is called
 

Source/Deserialization/XMLDeserialization.swift renamed to Source/Deserialization/XMLValueDeserialization.swift

@@ -25,7 +25,7 @@
 
 import Foundation
 
-extension Bool: XMLDeserialization, XMLElementDeserializable {
+extension Bool: XMLValueDeserialization {
     // swiftlint:disable line_length
     /**
      Attempts to deserialize XML element content to a Bool. This uses NSString's 'boolValue'

Source/DeserializationTypes/Bool+XMLDeserialization.swift

@@ -25,7 +25,7 @@
 
 import Foundation
 
-extension Double: XMLDeserialization, XMLElementDeserializable {
+extension Double: XMLValueDeserialization {
     /**
     Attempts to deserialize XML element content to a Double
 

Source/DeserializationTypes/Double+XMLDeserialization.swift

@@ -25,7 +25,7 @@
 
 import Foundation
 
-extension Float: XMLDeserialization {
+extension Float: XMLValueDeserialization {
     /**
     Attempts to deserialize XML element content to a Float
 

Source/DeserializationTypes/Float+XMLDeserialization.swift

@@ -25,7 +25,7 @@
 
 import Foundation
 
-extension Int: XMLDeserialization {
+extension Int: XMLValueDeserialization {
     /**
     Attempts to deserialize XML element content to a Int
 

Source/DeserializationTypes/Int+XMLDeserialization.swift

@@ -25,7 +25,7 @@
 
 import Foundation
 
-extension String: XMLDeserialization {
+extension String: XMLValueDeserialization {
     /**
     Attempts to deserialize XML element content to a String
 

Source/DeserializationTypes/String+XMLDeserialization.swift

@@ -637,7 +637,7 @@ class TypeConversionBasicTypesTests: XCTestCase {
 
 enum BasicItemValidation: Error { case priceOutOfBounds(Double) }
 
-struct BasicItem: XMLIndexerDeserializable {
+struct BasicItem: XMLObjectDeserialization {
     let name: String
     let price: Double
     let id: String

Tests/SWXMLHashTests/TypeConversionBasicTypesTests.swift

@@ -134,7 +134,7 @@ class TypeConversionComplexTypesTests: XCTestCase {
     }
 }
 
-struct ComplexItem: XMLIndexerDeserializable {
+struct ComplexItem: XMLObjectDeserialization {
     let name: String
     let priceOptional: Double?
     let basics: [BasicItem]