notwa/gists
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Browse source
This commit is contained in:
Connor 2016-08-18 19:50:10 -07:00 committed by GitHub
parent fd56c5124a
commit 8c8b5d313a
1 changed files with 16 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
kyaa.md
View file

@ -17,7 +17,7 @@ standard library headers:
ensure argc and argv are defined. ensure argc and argv are defined.
kyaa doesn't actually care if it's in main() or not. kyaa doesn't actually care if it's in main() or not.
iterate over the arguments with KYAA\_LOOP: iterate over the arguments with `KYAA_LOOP`:
```c ```c
int main(int argc, char *argv[]) { int main(int argc, char *argv[]) {
@ -29,8 +29,8 @@ int main(int argc, char *argv[]) {
} }
``` ```
use KYAA\_BEGIN and KYAA\_END to begin parsing arguments. use `KYAA_BEGIN` and `KYAA_END` to begin parsing arguments.
put unrelated code above KYAA\_BEGIN or below KYAA\_END, but not within: put unrelated code above `KYAA_BEGIN` or below `KYAA_END`, but not within:
```c ```c
KYAA_LOOP { KYAA_LOOP {
@ -43,8 +43,8 @@ put unrelated code above KYAA\_BEGIN or below KYAA\_END, but not within:
} }
``` ```
use KYAA\_FLAG for defining flags that don't take an argument, use `KYAA_FLAG` for defining flags that don't take an argument,
and KYAA\_FLAG\_ARG or KYAA\_FLAG\_LONG for flags that do: and `KYAA_FLAG_ARG` or `KYAA_FLAG_LONG` for flags that do:
```c ```c
bool use_feature = false; bool use_feature = false;
@ -78,8 +78,8 @@ and KYAA\_FLAG\_ARG or KYAA\_FLAG\_LONG for flags that do:
kyaa secretly wraps flag handling in if/else statements with {} blocks. kyaa secretly wraps flag handling in if/else statements with {} blocks.
do not confuse it for a switch/case method. do not confuse it for a switch/case method.
kyaa handles -h and --help for printing help text. kyaa handles `-h` and `--help` for printing help text.
additional help text may be defined using KYAA\_HELP: additional help text may be defined using `KYAA_HELP`:
```c ```c
KYAA_LOOP { KYAA_LOOP {
@ -93,25 +93,25 @@ additional help text may be defined using KYAA\_HELP:
} }
``` ```
kyaa interprets an argument of "-" as a request to enable reading from stdin: kyaa interprets an argument of `-` as a request to enable reading from stdin:
kyaa\_read\_stdin is set to true. `kyaa_read_stdin` is set to true.
arguments may be passed in three ways, consider: arguments may be passed in three ways, consider:
* `-v42` * `-v42`
* `-v 42` * `-v 42`
* `--var 42` * `--var 42`
kyaa returns KYAA\_OKAY when -h or --help is given, kyaa returns `KYAA_OKAY` when `-h` or `--help` is given,
and KYAA\_ERROR in the event of invalid flags, missing arguments, and `KYAA_ERROR` in the event of invalid flags, missing arguments,
or invalid numbers (KYAA\_FLAG\_LONG). or invalid numbers (`KYAA_FLAG_LONG`).
kyaa uses continue for handling arguments. kyaa uses continue for handling arguments.
kyaa prints error messages to stderr, and help text to stdout. kyaa prints error messages to `stderr`, and help text to `stdout`.
KYAA\_ITER may be redefined to avoid name collisions. `KYAA_ITER` may be redefined to avoid name collisions.
## TODO ## TODO
* support `--var=42` argument style * support `--var=42` argument style
* rename overlapping things, e.g. KYAA\_FLAG vs kyaa\_flag, KYAA\_FLAG\_ARG vs kyaa\_flag\_arg, etc. * rename overlapping things, e.g. `KYAA_FLAG` vs `kyaa_flag`, `KYAA_FLAG_ARG` vs `kyaa_flag_arg`, etc.
* move KYAA\_FLAG\_ARG to `kyaa_extend.h` or something; write similar macros. * move `KYAA_FLAG_ARG` to `kyaa_extend.h` or something; write similar macros.