add generic binary cookies manager

XXTouch.xcodeproj/xcshareddata/xcschemes/CookiesTool.xcscheme

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1340"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "CC544D97287AD31400613A4E"
+               BuildableName = "CookiesTool"
+               BlueprintName = "CookiesTool"
+               ReferencedContainer = "container:XXTouch.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "CC544D97287AD31400613A4E"
+            BuildableName = "CookiesTool"
+            BlueprintName = "CookiesTool"
+            ReferencedContainer = "container:XXTouch.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "CC544D97287AD31400613A4E"
+            BuildableName = "CookiesTool"
+            BlueprintName = "CookiesTool"
+            ReferencedContainer = "container:XXTouch.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

XXTouch.xcodeproj/xcshareddata/xcschemes/alert.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1320"
+   LastUpgradeVersion = "1340"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

XXTouch.xcodeproj/xcshareddata/xcschemes/lua-dynamic.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1320"
+   LastUpgradeVersion = "1340"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

XXTouch.xcodeproj/xcshareddata/xcschemes/memory.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1320"
+   LastUpgradeVersion = "1340"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

XXTouch.xcodeproj/xcshareddata/xcschemes/monkey.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1320"
+   LastUpgradeVersion = "1340"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

XXTouch.xcodeproj/xcshareddata/xcschemes/simulatetouchd.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1320"
+   LastUpgradeVersion = "1340"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

XXTouch.xcodeproj/xcshareddata/xcschemes/touch.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1320"
+   LastUpgradeVersion = "1340"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

app/CookiesTool/BinaryCodable/BinaryCodable.swift

@@ -0,0 +1,25 @@
+// Copyright 2019-present the BinaryCodable authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Note: the types described below are based off - but distinct from - Swift's Codable family of APIs.
+
+/**
+ A type that can convert itself into and out of an external binary representation.
+ */
+public typealias BinaryCodable = BinaryDecodable & BinaryEncodable
+
+/**
+ A user-defined key for providing context during binary encoding and decoding.
+ */
+public typealias BinaryCodingUserInfoKey = String

app/CookiesTool/BinaryCodable/BinaryDataCoders/BinaryDataDecoder.swift

@@ -0,0 +1,232 @@
+// Copyright 2019-present the BinaryCodable authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import Foundation
+
+/**
+ An object that decodes instances of a type from binary data as a sequential series of bytes.
+ */
+public struct BinaryDataDecoder {
+  public init() {}
+
+  /**
+   Contextual user-provided information for use during decoding.
+   */
+  public var userInfo: [BinaryCodingUserInfoKey: Any] = [:]
+
+  /**
+   Returns a type you specify decoded from data.
+
+   - parameter type: The type of the instance to be decoded.
+   - parameter data: The data from which the instance should be decoded.
+   - returns: An instance of `type` decoded from `data`.
+   */
+  public func decode<T>(_ type: T.Type, from data: Data) throws -> T where T: BinaryDecodable {
+    return try decode(type, from: bufferedData(from: data))
+  }
+
+  /**
+   Returns a type you specify decoded from a sequence of bytes.
+
+   - parameter type: The type of the instance to be decoded.
+   - parameter bytes: The sequence of bytes from which the instance should be decoded.
+   - returns: An instance of `type` decoded from `bytes`.
+   */
+  public func decode<T>(_ type: T.Type, from bytes: [UInt8]) throws -> T where T: BinaryDecodable {
+    return try decode(type, from: bufferedData(from: Data(bytes)))
+  }
+
+  public func decode<T>(_ type: T.Type, from bufferedData: BufferedData) throws -> T where T: BinaryDecodable {
+    return try T.init(from: _BinaryDataDecoder(bufferedData: bufferedData, userInfo: userInfo))
+  }
+}
+
+private struct _BinaryDataDecoder: BinaryDecoder {
+  var bufferedData: BufferedData
+  let userInfo: [BinaryCodingUserInfoKey: Any]
+  let container: BinaryDataDecodingContainer?
+
+  init(bufferedData: BufferedData, userInfo: [BinaryCodingUserInfoKey: Any]) {
+    self.bufferedData = bufferedData
+    self.userInfo = userInfo
+    self.container = nil
+  }
+
+  init(bufferedData: BufferedData, userInfo: [BinaryCodingUserInfoKey: Any], container: BinaryDataDecodingContainer) {
+    self.bufferedData = bufferedData
+    self.userInfo = userInfo
+    self.container = container
+  }
+
+  func container(maxLength: Int?) -> BinaryDecodingContainer {
+    if let remainingLength = container?.remainingLength {
+      if let maxLength = maxLength {
+        return BinaryDataDecodingContainer(bufferedData: bufferedData,
+                                           maxLength: min(maxLength, remainingLength),
+                                           userInfo: userInfo)
+      } else {
+        return BinaryDataDecodingContainer(bufferedData: bufferedData,
+                                           maxLength: remainingLength,
+                                           userInfo: userInfo)
+      }
+    } else {
+      return BinaryDataDecodingContainer(bufferedData: bufferedData, maxLength: maxLength, userInfo: userInfo)
+    }
+  }
+}
+
+// This needs to be a class instead of a struct because we hold a mutating reference in decode<T>.
+private class BinaryDataDecodingContainer: BinaryDecodingContainer {
+  var bufferedData: BufferedData
+  var remainingLength: Int?
+  let userInfo: [BinaryCodingUserInfoKey: Any]
+  init(bufferedData: BufferedData, maxLength: Int?, userInfo: [BinaryCodingUserInfoKey: Any]) {
+    self.bufferedData = bufferedData
+    self.remainingLength = maxLength
+    self.userInfo = userInfo
+  }
+
+  var isAtEnd: Bool {
+    if let remainingLength = remainingLength {
+      return remainingLength == 0 || bufferedData.isAtEnd
+    }
+    return bufferedData.isAtEnd
+  }
+
+  func decode<T: BinaryFloatingPoint>(_ type: T.Type) throws -> T {
+    let byteWidth = (type.significandBitCount + type.exponentBitCount + 1) / 8
+    let bytes = try pullData(length: byteWidth)
+    if bytes.count < byteWidth {
+      throw BinaryDecodingError.dataCorrupted(.init(debugDescription:
+        "Not enough data to create a a type of \(type). Needed: \(byteWidth). Received: \(bytes.count)."))
+    }
+    return bytes.withUnsafeBytes { ptr in
+      var value: T = 0
+      withUnsafeMutableBytes(of: &value) { valuePtr in
+        valuePtr.copyMemory(from: UnsafeRawBufferPointer(rebasing: ptr[0..<ptr.count]))
+      }
+      return value
+    }
+  }
+
+  func decode<T: FixedWidthInteger>(_ type: T.Type) throws -> T {
+    let byteWidth = type.bitWidth / 8
+    let bytes = try pullData(length: byteWidth)
+    if bytes.count < byteWidth {
+      throw BinaryDecodingError.dataCorrupted(.init(debugDescription:
+        "Not enough data to create a a type of \(type). Needed: \(byteWidth). Received: \(bytes.count)."))
+    }
+    return bytes.withUnsafeBytes { ptr in
+      var value: T = 0
+      withUnsafeMutableBytes(of: &value) { valuePtr in
+        valuePtr.copyMemory(from: UnsafeRawBufferPointer(rebasing: ptr[0..<ptr.count]))
+      }
+      return value
+    }
+  }
+
+  func decodeString(encoding: String.Encoding, terminator: UInt8?) throws -> String {
+    let data: Data
+    if let terminator = terminator {
+      let result = try bufferedData.read(until: terminator)
+      guard result.didFindDelimiter else {
+        throw BinaryDecodingError.dataCorrupted(.init(debugDescription:
+          "Unable to find delimiter for string."))
+      }
+      data = result.data
+    } else {
+      data = try bufferedData.read(maxBytes: Int.max)
+    }
+    if let remainingLength = remainingLength {
+      self.remainingLength = remainingLength - (data.count + 1)
+    }
+    guard let string = String(data: data, encoding: encoding) else {
+      throw BinaryDecodingError.dataCorrupted(.init(debugDescription:
+        "Unable to create string from data with \(encoding) encoding."))
+    }
+    return string
+  }
+
+  func decode<T>(_ type: T.Type) throws -> T where T: BinaryDecodable {
+    return try T.init(from: _BinaryDataDecoder(bufferedData: containedBuffer(), userInfo: userInfo, container: self))
+  }
+
+  func decode(length: Int) throws -> Data {
+    let data = try pullData(length: length)
+    if data.count != length {
+      throw BinaryDecodingError.dataCorrupted(.init(debugDescription:
+        "Not enough bytes available to decode. Requested \(length), but received \(data.count)."))
+    }
+    return data
+  }
+
+  func decodeRemainder() throws -> Data {
+    return try pullData(length: Int.max)
+  }
+
+  func nestedContainer(maxLength: Int?) -> BinaryDecodingContainer {
+    let length: Int?
+    let bufferedData: BufferedData
+    if let remainingLength = remainingLength {
+      if let maxLength = maxLength {
+        length = min(remainingLength, maxLength)
+      } else {
+        length = remainingLength
+      }
+      bufferedData = containedBuffer()
+    } else {
+      length = maxLength
+      bufferedData = self.bufferedData
+    }
+    return BinaryDataDecodingContainer(bufferedData: bufferedData, maxLength: length, userInfo: userInfo)
+  }
+
+  func pullData(length: Int) throws -> Data {
+    let maxLength: Int
+    if let remainingLength = remainingLength {
+      maxLength = min(remainingLength, length)
+    } else {
+      maxLength = length
+    }
+    let data = try bufferedData.read(maxBytes: maxLength)
+    if let remainingLength = remainingLength {
+      self.remainingLength = remainingLength - data.count
+    }
+    return data
+  }
+
+  func peek(length: Int) throws -> Data {
+    let maxLength: Int
+    if let remainingLength = remainingLength {
+      maxLength = min(remainingLength, length)
+    } else {
+      maxLength = length
+    }
+    let data = try bufferedData.peek(maxLength: maxLength)
+    if data.count != length {
+      throw BinaryDecodingError.dataCorrupted(.init(debugDescription:
+        "Not enough bytes available to decode. Requested \(length), but received \(data.count)."))
+    }
+    return data
+  }
+
+  private func containedBuffer() -> BufferedData {
+    return BufferedData(reader: AnyBufferedDataSource(read: { recommendedAmount -> Data? in
+      let data = try self.pullData(length: recommendedAmount)
+      return data.count > 0 ? data : nil
+    }, isAtEnd: {
+      return self.isAtEnd
+    }))
+  }
+}