qix-/xopt

ANSI C command line options parser

XOpt

The sane answer to POpt.

XOpt is a command line argument parsing library written in ANSI C. XOpt accepts arguments in GNU format and focuses on clean definition, taking stress off the implementation.

License

Originally by Josh Junon, released under CC0. Go nuts.

xopt's Issues

Autohelp doesn't appear to use context's arg0 property and doesn't prefix usage

Having to specify usage: some-program-name kind of defeats the purpose of both specifying the argv[0] and the usage information in autohelp.

Extra arguments array doesn't have a null terminator

It should, in order to comply with common standards and conventions surrounding argv. It just caused an annoying bug when passing extrav to libuv.

'--' (doubledash) is being included as part of extras

-- should be eaten, not included in the returned "extras" array.

'-'

Specifying - by itself should should cause it to be returned as an extra.

However, it's being parsed as a singular option and simply getting ignored.

Sloppy shorts are broken

Sloppy shorts don't seem to work.

6: Test command: /src/qix-/xopt/test/test-case.sh "/src/qix-/xopt/build/xopt-test-sloppyshorts" "/src/qix-/xopt/test/sloppyshorts.out" "-i10" "-d" "14.5" "-s"some string"" "--" "--is-not-passed" "ignoreme"
6: Test timeout computed to be: 10000000
6: error: xopt test case failed (1):
6: args: «-i10» «-d» «14.5» «-s"some string"» «--» «--is-not-passed» «ignoreme»
6:
6: Error: short options cannot be combined: -i10
6/6 Test #6: xopt-sloppyshorts-test ...........***Failed    0.02 sec

Add macro for automatically generating an option parser block

Add an XOPT_SANE_PARSE() macro that parses command line options and performs autohelp and whatnot instead of requiring a bunch of context variables and whatnot - ultimately a one-liner for parsing options.

nocondense and sloppyshorts conflict

xopt/xopt.c

Line 326 in 4b1ff68

if (length > 1 && ctx->flags & XOPT_CTX_NOCONDENSE) {

That check will conflict if sloppy shorts are enabled and a short arg that takes an argument is supplied.

Long args should be optional

Setting long args to NULL causes a segfault whereas shortargs can be 0 without issue.

After short options were fixed, double-options broke

Yes, this was working prior. 😐

static void on_verbose(const char *v, void *data, const struct xoptOption *option, bool longArg, const char **err) {
	(void) v;
	(void) option;
	(void) err;

	config *conf = (config *) data;

	assert(!longArg);

	if (conf->verbosity < 3) {
		++conf->verbosity;
	}
}

// ...
	{
		0, // only allow -v[v[v]]
		'v',
		offsetof(config, verbosity),
		&on_verbose,
		XOPT_TYPE_BOOL,
		0,
		"Increase verbosity (default level 0, max level 3)"
	},
// ...

$ ./app -vv
error: option doesn't take a value: -v