# 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:
```rust
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.