starbase_args

A generic command line parser.

This is more than just an argument parser; it supports "full" command line syntax including piping, redirection, expansion, and substitution. It organizes parsed tokens into a structured format using Rust enums and structs.

For example, the command git rebase -i --empty=drop --exec "echo" HEAD~3 would be parsed into:

CommandLine(vec![
	Pipeline::Start(CommandList(vec![
		Sequence::Start(Command(vec![
			Argument::Value(Value::Unquoted("git".into())),
			Argument::Value(Value::Unquoted("rebase".into())),
			Argument::Flag("-i".into()),
			Argument::Option("--empty".into(), Some(Value::Unquoted("drop".into()))),
			Argument::Option("--exec".into(), None),
			Argument::Value(Value::DoubleQuoted("echo".into())),
			Argument::Value(Value::Unquoted("HEAD~3".into())),
		]))
	]))
])

The following shells are shells "supported":

• Sh (and derivatives: Bash, Zsh, etc)
• Elvish
• Fish
• Ion
• Murex (partial)
• Nu
• Pwsh
• Xonsh (partial)

Caveats

This library only supports parsing command line syntax that you would enter into a terminal. For example: commands, arguments, options, flags, redirections, pipelines, expansions, substitutions, etc.

It does not support parsing shell specific syntax such as control flow (if/else), variable assignments, functions, etc.

Additionally, while this library aims to support multiple shells, it may not cover all edge cases or unique syntax of every shell! Just syntax that is generic and common enough across them.