Kargs aim to make cli arguments function like Janet arguments. This follows a few simple rules.
- If we're not expecting a value, we try to parse a flag.
- A flag is defined as either a short flag or a long flag.
A short flag can be
-aor-abcd(this becomes an:abcdkeyword, for use as flags). A long flag can be--abcd=value(where value is parsed as in 3) or--abcd(in which case the value is expected to be the next argument). - If a flag is matched, flag semantics (as above) take over. Otherwise, or if we expect a value, we parse it using the Janet parser. If the parser outputs a symbol or fails to parse the value, we turn it into an as-is string.
And that's it. Have fun!
Note that this library is not stable, I reserve the right to change it whenever until 1.0.0 is tagged. This is because I'm going to pull a hehecat and use it in production to see if it feels right or not.
Technically, I use parse and not parse-all.
I probably should use parse-all and also check for length.
I don't care though.
Test condition: "1 hi" should result in "1 hi" but results in 1.