commandlineparser/commandline
Commandline
This library is a .NET command line parser for C# and F# that implements POSIX getopt conventions to map shell arguments into strongly typed objects. It provides a framework for building console applications that process Unix-style flags and options.
The project features a routing system that directs program execution based on action-oriented verbs, supporting sub-commands and default actions. It includes an automatic help generator that produces localized usage instructions and formatted help screens based on the defined command options.
The toolset covers argument parsing with strongly typed mapping, input validation for mutually exclusive or required options, and the ability to serialize populated option objects back into command line strings.
Features
- Command Line Argument Parsers - Implements logic for parsing raw shell input strings into structured objects based on defined requirements.
- Command Line Argument Parsing - Implements a strongly typed parser for mapping shell arguments into C# and F# objects.
- Argument Grouping - Groups related options to ensure at least one is selected, preventing parsing errors.
- CLI Command Dispatchers - Implements a mapping system to direct terminal input to internal logic handlers via nested verbs.
- Nested Command Structures - Organizes multiple distinct commands by assigning specific option classes to unique verb identifiers.
- CLI Command Routers - Directs application flow by matching input strings to specific command classes and their unique option sets.
- CLI Routers - Directs program execution flow by matching input verbs to specific command classes and unique option sets.
- Command Line Interface Routing - Command-line interface routing that directs program execution flow based on distinct action-based verbs similar to version control systems.
- Help Text Generators - Automatically generates and formats instructional documentation and usage screens for command-line tools.
- Argument Exclusivity Constraints - Provides logic to enforce that only one option from a defined set is used.
- CLI Argument Projections - Implements strongly typed mapping of raw terminal strings into structured C# or F# objects.
- Command-Line Type Mapping - Maps raw command-line strings into strongly typed C# objects through reflection and type conversion.
- CLI Argument Validators - Provides routines for validating command-line input, including required options and mutually exclusive flag combinations.
- Verb-Based Command Routing - A routing system that directs program flow to different execution paths by parsing specific verbs and their unique option sets.
- Default Command Fallbacks - Allows a specific command to execute automatically when no explicit verb is provided.
- Command Help Displays - Displays detailed usage instructions and available options for specific individual commands.
- POSIX CLI Compliance - Implements a .NET parser following standard POSIX conventions for command-line flags and arguments.
- Attribute-Driven Configurations - Implements declarative markers on properties to define command-line option constraints and help text.
- Command String Generators - Provides a utility to programmatically generate shell command strings from populated option objects.
- CLI Tools - Concise API for manipulating command-line arguments.
- Dotnet CLI Frameworks - API for manipulating command-line arguments.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
