swift-argument-parser icon indicating copy to clipboard operation
swift-argument-parser copied to clipboard

Permit asynchronous code to be given to the custom completion type

Open thafner0 opened this issue 2 years ago • 1 comments

At the moment the custom case of the CompletionKind enumeration supports being given a custom closure to generate completions on the command line. However, since the provided closure must be synchronous, it is difficult to incorporate functionality that requires swift's concurrency features. The lack of this functionality prevents certain tasks from being possible with these completions and causes other tasks to be possible, but only in a non-thread safe way. Examples of this include working with databases (such as those managed by Apple's Core Data framework).

Example:

struct SomeCommand: AsyncParseableCommand {

@Argument(help: "<Helpful help>", completion: .custom({ arguments in
return try? await completionGenerator(arguments: arguments) ?? []
}))
var argument: String

mutating func run() async throws {
// Code that makes the command Run
}
}

@MainActor
private func completionGenerator(arguments: [String]) async throws -> [String] {
// Code that generates completions that has some asynchronous system in use and/or must be run on the main actor.
}

thafner0 avatar Feb 21 '23 23:02 thafner0

This would be great, along with completion we could really use this for transform.

@natecook1000 is this something you think would be wanted? I could work on this if you don't think it's too complicated as a first task

luispadron avatar Jun 15 '23 20:06 luispadron