mirror of
https://github.com/apple/swift-argument-parser.git
synced 2026-06-06 20:18:23 +00:00
51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
# ``ArgumentParser/AsyncParsableCommand``
|
|
|
|
To use `async`/`await` code in your commands' `run()` method implementations, follow these steps:
|
|
|
|
1. For the root command in your command-line tool, declare conformance to `AsyncParsableCommand`, whether or not that command uses asynchronous code.
|
|
2. Apply the `@main` attribute to the root command. (Note: If your root command is in a `main.swift` file, rename the file to the name of the command.)
|
|
3. For any command that needs to use asynchronous code, declare conformance to `AsyncParsableCommand` and mark the `run()` method as `async`. No changes are needed for subcommands that don't use asynchronous code.
|
|
|
|
The following example declares a `CountLines` command that uses Foundation's asynchronous `FileHandle.AsyncBytes` to read the lines from a file:
|
|
|
|
```swift
|
|
import Foundation
|
|
|
|
@main
|
|
struct CountLines: AsyncParsableCommand {
|
|
@Argument(transform: URL.init(fileURLWithPath:))
|
|
var inputFile: URL
|
|
|
|
mutating func run() async throws {
|
|
let fileHandle = try FileHandle(forReadingFrom: inputFile)
|
|
let lineCount = try await fileHandle.bytes.lines.reduce(into: 0)
|
|
{ count, _ in count += 1 }
|
|
print(lineCount)
|
|
}
|
|
}
|
|
```
|
|
|
|
> Note: The Swift compiler uses either the type marked with `@main` or a `main.swift` file as the entry point for an executable program. You can use either one, but not both — rename your `main.swift` file to the name of the command when you add `@main`.
|
|
|
|
### Usage in Swift 5.5
|
|
|
|
In Swift 5.5, you need to declare a separate, standalone type as your asynchronous `@main` entry point. Instead of designating your root command as `@main`, as described above, use the code snippet below, replacing the placeholder with the name of your own root command. Otherwise, follow the steps above to use `async`/`await` code within your commands' `run()` methods.
|
|
|
|
```swift
|
|
@main struct AsyncMain: AsyncMainProtocol {
|
|
typealias Command = <#RootCommand#>
|
|
}
|
|
```
|
|
|
|
## Topics
|
|
|
|
### Implementing a Command's Behavior
|
|
|
|
- ``run()``
|
|
|
|
### Starting the Program
|
|
|
|
- ``main()``
|
|
- ``AsyncMainProtocol``
|
|
|