Revert "Update swift-argument-parser (#32)" (#34)

This reverts commit a8a9b4a.

Author: shahmishal

Package.resolved

@@ -114,7 +114,7 @@ if ProcessInfo.processInfo.environment["SWIFTCI_USE_LOCAL_DEPS"] == nil {
         .package(url: "https://github.com/apple/swift-nio-ssl.git", .upToNextMinor(from: "2.15.0")),
         .package(name: "swift-markdown", url: "https://github.com/apple/swift-markdown.git", .branch("main")),
         .package(name: "CLMDB", url: "https://github.com/apple/swift-lmdb.git", .branch("main")),
-        .package(url: "https://github.com/apple/swift-argument-parser", .upToNextMinor(from: "1.0.1")),
+        .package(url: "https://github.com/apple/swift-argument-parser", .upToNextMinor(from: "0.4.4")),
         .package(name: "SymbolKit", url: "https://github.com/apple/swift-docc-symbolkit", .branch("main")),
         .package(url: "https://github.com/apple/swift-crypto.git", .upToNextMinor(from: "1.1.2")),
     ]

Package.swift

@@ -185,6 +185,14 @@ extension Docc {
         """))
         public var diagnosticLevel: String?
 
+        // Parse and ignore any unrecognized flags, options, and input.
+        //
+        // When we're adding new flags or options to the `convert` command. This behavior allows us to also land
+        // changes in other tools that pass these values to `docc convert` without coordinating the two releases.
+        
+        @Argument(parsing: .unconditionalRemaining, help: .hidden)
+        var unrecognizedArgumentsAndOptions: [String] = []
+        
         // MARK: - Computed Properties
 
         /// The path to the directory that all build output should be placed in.
@@ -214,6 +222,10 @@ extension Docc {
                 """)
             }
 
+            if !unrecognizedArgumentsAndOptions.isEmpty {
+                print("note: The following arguments, options, and flags were not recognized and will be ignored: \(unrecognizedArgumentsAndOptions)")
+            }
+            
             if let outputParent = providedOutputURL?.deletingLastPathComponent() {
                 var isDirectory: ObjCBool = false
                 guard FileManager.default.fileExists(atPath: outputParent.path, isDirectory: &isDirectory), isDirectory.boolValue else {

Sources/SwiftDocCUtilities/ArgumentParsing/Subcommands/Convert.swift

@@ -289,6 +289,21 @@ class ConvertSubcommandTests: XCTestCase {
         }
     }
 
+    func testExtraArgumentsAreIgnored() throws {
+        setenv(TemplateOption.environmentVariableKey, testTemplateURL.path, 1)
+        
+        let convertOptions = try Docc.Convert.parse([
+            testBundleURL.path,
+            // These are unrecognized
+            "--extra-option", "\"extra value\"",
+            "--extra-flag",
+            // This flag is recognized
+            "--analyze"
+        ])
+        
+        XCTAssertEqual(convertOptions.unrecognizedArgumentsAndOptions, ["--extra-option", "\"extra value\"", "--extra-flag"])
+    }
+    
     func testIndex() throws {
         setenv(TemplateOption.environmentVariableKey, testTemplateURL.path, 1)