Update format

.githooks/pre-commit

@@ -16,7 +16,7 @@ elif ! [ -x "$(command -v swift-format)" ]; then
   ln -s /Applications/Xcode.app/Contents/Developer/usr/bin/generate-pipeline /usr/local/bin/generate-pipeline
 else
   echo "Linting..."
-  git diff --diff-filter=d --cached --name-only | grep -E '\.(swift)$' | xargs -I{} swift-format -m lint --configuration .swift-format -i {}
+  git diff --diff-filter=d --cached --name-only | grep -E '\.(swift)$' | xargs -I{} swift-format -m lint --configuration .swift-format {}
   echo "Auto-Formatting..."
   git diff --diff-filter=d --cached --name-only | grep -E '\.(swift)$' | xargs -I{} swift-format -m format -r --configuration .swift-format -i {}
 fi

.swift-format

@@ -16,7 +16,7 @@
     "AlwaysUseLowerCamelCase" : true,
     "AmbiguousTrailingClosureOverload" : true,
     "BeginDocumentationCommentWithOneLineSummary" : true,
-    "BlankLineBetweenMembers" : true,
+    "BlankLineBetweenMembers" : false,
     "CaseIndentLevelEqualsSwitch" : true,
     "DoNotUseSemicolons" : true,
     "DontRepeatTypeInStaticProperties" : true,

README.md

@@ -3,6 +3,27 @@
 This package help to find/filter/sort all devices and runtimes available in xcrun simctl.
 
 ```swift
+#!/usr/bin/swift sh
+
+import Foundation
+import PlatformLookup  // @mackoj
+
+func findDevicePlatform(_ args: [String]) throws {
+  if let platform: String = try PlatformLookup.findADeviceForLastOSVersion() {
+    // Expecting: iOS Simulator,name=iPhone 11 Pro Max,OS=13.2
+    print(platform)
+  } else {
+    print("👉 Failure 💩")
+    exit(EXIT_FAILURE)
+  }
+}
+
+do {
+  try findDevicePlatform(CommandLine.arguments)
+} catch {
+  print(error.localizedDescription)
+  exit(EXIT_FAILURE)
+}
 ```
 
 # SimulatorControl 📲

Sources/PlatformLookup/PlatformLookup+Error.swift

@@ -6,6 +6,7 @@ extension PlatformLookup {
     case failedToInitializeDataIsNotValid
     case unknowDeviceFamilly(String)
     case noRuntimeFound
+    /// A localized message describing what error occurred.
     public var errorDescription: String? {
       switch self {
       case .failedToInitializeDataIsNotValid:
@@ -18,5 +19,20 @@ extension PlatformLookup {
       case .noRuntimeFound: return NSLocalizedString("Runtime unknown", comment: "Unknown Runtime")
       }
     }
+    /// A localized message describing the reason for the failure.
+    public var failureReason: String? {
+      return "failureReason"  //      switch self {
+      //      case .failedToInitializeDataIsNotValid:
+      //        <#code#>
+      //      case .unknowDeviceFamilly(_):
+      //        <#code#>
+      //      case .noRuntimeFound:
+      //        <#code#>
+      //      }
+    }
+    /// A localized message describing how one might recover from the failure.
+    public var recoverySuggestion: String? { return "failureReason" }
+    /// A localized message providing "help" text if the user requests help.
+    public var helpAnchor: String? { return "failureReason" }
   }
 }

TODO.md

@@ -3,6 +3,7 @@
 ## P0
 - [ ] Add missing tests
 - [ ] Remove all the warnings
+- [ ] Add simple script to call them
 
 ## P1
 - [ ] Code Documentation
@@ -14,3 +15,4 @@
 - [ ] PR Boiler plate
 - [ ] Auto review
 - [ ] Dr String
+- [ ] How to help translate error message

findDevicePlatform.swift

@@ -0,0 +1,18 @@
+import Foundation
+// import PlatformLookup  // mackoj/SimulatorControl ~> 0.8.0
+import PlatformLookup  // https://github.com/mackoj/SimulatorControl  == a037a15
+
+func findDevicePlatform(_ args: [String]) throws {
+  if let platform:String = try PlatformLookup.findADeviceForLastOSVersion() {
+    // Expecting: iOS Simulator,name=iPhone 11 Pro Max,OS=13.2
+    print(platform)
+  } else {
+    print("👉 Failure 💩")
+    exit(EXIT_FAILURE)
+  }
+}
+
+do { try findDevicePlatform(CommandLine.arguments) } catch {
+  print(error.localizedDescription)
+  exit(EXIT_FAILURE)
+}