test URLComponentsParser with convenience parsers

Sources/URLSchemer/NSAppleEventDescriptor+URLComponents.swift

@@ -1,6 +1,7 @@
 import AppKit
 
 extension NSAppleEventDescriptor {
+    @usableFromInline
     var urlComponents: URLComponents? {
         guard let urlString = self.paramDescriptor(forKeyword: AEKeyword(keyDirectObject))?.stringValue 
         else { return nil }

Sources/URLSchemer/Parsers/URLComponentsParser.swift

@@ -11,6 +11,28 @@ extension URLComponents {
     }
 }
 
+extension URLComponents {
+    public func parse<Parsers: ActionParser, Output: Action>(
+        @OneOfBuilder<StringAction, Output> _ build: () -> Parsers
+    ) rethrows -> Output
+    where Parsers.Input == StringAction, Parsers.Output == Output
+    {
+        return try Self.parse(self, build)
+    }
+
+    public static func parse<Parsers: ActionParser, Output: Action>(
+        _ input: URLComponents,
+        @OneOfBuilder<StringAction, Output> _ build: () -> Parsers
+    ) rethrows -> Output
+    where Parsers.Input == StringAction, Parsers.Output == Output
+    {
+        let combined = parser.flatMap {
+            OneOf(build)
+        }
+        return try combined.parse(input)
+    }
+}
+
 public struct URLComponentsParser: ActionParser {
     @inlinable
     public init() { }

Tests/URLSchemerTests/AppControlParserTests.swift

@@ -3,7 +3,7 @@ import XCTest
 
 final class AppControlParserTests: XCTestCase {
     func testTerminate() throws {
-        let action = try URLComponents.parser.flatMap {
+        let action = try URLComponentsParser().flatMap {
             AppControlParser()
         }.parse(XCTUnwrap(URLComponents(string: "example://app/control/terminate")))
 

Tests/URLSchemerTests/FlatMapTests.swift

@@ -23,12 +23,6 @@ final class FlatMapTests: XCTestCase {
         }
     }
 
-    struct PassthroughParser<Input: Action>: ActionParser {
-        func parse(_ input: Input) throws -> some Action {
-            input
-        }
-    }
-
     func testSuccess() {
         let result = Just(ActionStub(subject: "apple"))
             .flatMap {

Tests/URLSchemerTests/Helpers/Passthrough.swift

@@ -0,0 +1,7 @@
+import URLSchemer
+
+struct Passthrough<Input: Action>: ActionParser {
+    func parse(_ input: Input) throws -> Input {
+        input
+    }
+}

Tests/URLSchemerTests/URLComponentsParserTests.swift

@@ -0,0 +1,17 @@
+import URLSchemer
+import XCTest
+
+final class URLComponentsParserTests: XCTestCase {
+    func testParse() throws {
+        let components = try XCTUnwrap(URLComponents(string: "example://module/subject/verb"))
+        XCTAssertEqual(try URLComponentsParser().parse(components), StringAction(module: "module", subject: "subject", verb: "verb"))
+    }
+
+    func testParseWithFlatMap() throws {
+        let components = try XCTUnwrap(URLComponents(string: "myapp://amazing/action/execute/withpower?intensity=9000"))
+        let result = try components.parse {
+            Passthrough<StringAction>()
+        }
+        XCTAssertEqual(result, StringAction(module: "amazing", subject: "action", verb: "execute", object: "withpower", payload: ["intensity":"9000"]))
+    }
+}