apple/swift-argument-parser
3,728 stars·386 forks·Swift·Apache-2.0·10 viewsswiftpackageindex.com/apple/swift-argument-parser/documentation↗
Swift Argument Parser
This is a library for building command-line interfaces in Swift. It converts command-line arguments into type-safe Swift properties using a declarative approach, ensuring that inputs match expected data types to prevent runtime errors.
The framework supports the creation of complex command hierarchies through nested subcommands. It automatically generates formatted usage documentation and error messages by deriving information from the defined metadata and types.
The system utilizes property wrappers to attach parsing logic to types and employs reflection to extract metadata from property names and types at runtime.
Features
- Command Line Argument Parsing - Processes command-line flags and arguments, converting raw input into type-safe Swift properties.
- Nested Command Structures - Provides hierarchical organization of CLI commands into sub-commands and groups using a declarative tree of types.
- Command Line Argument Parsers - Parses raw shell input strings into structured, type-safe Swift objects based on defined requirements.
- Subcommand Parsers - Enables the creation of complex command hierarchies with nested sub-commands and automatic help generation.
- Type-Safe Argument Mappings - Converts raw command-line string input into strongly typed Swift properties through a generic decoding layer.
- CLI Frameworks - Provides a declarative framework for building type-safe command-line interfaces in Swift.
- CLI Frameworks - Provides a type-safe framework where command-line arguments and options map directly to Swift types.
- Automated Help Generators - Automatically produces usage instructions and option descriptions for command-line interfaces from the defined command hierarchy.
- Property Wrapper Declarations - Uses Swift property wrappers to attach parsing logic and metadata to command-line arguments.
- Reflection-Based Property Accessors - Employs runtime reflection to inspect property names and types to determine argument requirements.
- Argument Parsing - Type-safe and straightforward argument parsing utility.
- Command Line Tools - Type-safe argument parsing for Swift.
- Command Line Utilities - Parse command-line arguments in Swift applications.
