[Question] Syntax of templates

[vmelamed]

I could not find it so far but is there something more to templates' syntax than just: <short option>|<long option> {<value>}. For example, can I specify <short option>|<long option> [<value1>|<value2>|<value3>] (specify the three possible values for the option), or <short option>|<long option> <key>=<value>} (specify a tuple or if multiple - a dictionary), etc.

[natemcmaster]

This is something the documentation could clarify. But in the absence of that, here are the test cases which demonstrate currently supported syntax:

CommandLineUtils/test/CommandLineUtils.Tests/CommandOptionTests.cs

Lines 12 to 31 in 81199c7

	[Theory]
	[InlineData("-a", "a", null, null, null)]
	[InlineData("-abc", "abc", null, null, null)]
	[InlineData("-a|--name", "a", null, "name", null)]
	[InlineData("-a|--name <VALUE>", "a", null, "name", "VALUE")]
	[InlineData("-a|--name <VALUE> <VALUE2>", "a", null, "name", "VALUE2")]
	[InlineData("-a <VALUE>", "a", null, null, "VALUE")]
	[InlineData("-?|-a", "a", "?", null, null)]
	[InlineData("-?|-a|--name", "a", "?", "name", null)]
	[InlineData("-?|-a|--name <VALUE>", "a", "?", "name", "VALUE")]
	[InlineData("-?|-a <VALUE>", "a", "?", null, "VALUE")]
	[InlineData("-? <VALUE>", null, "?", null, "VALUE")]
	[InlineData("-a --name", "a", null, "name", null)]
	[InlineData("-a --name <VALUE>", "a", null, "name", "VALUE")]
	[InlineData("-a -? --name <VALUE>", "a", "?", "name", "VALUE")]
	[InlineData("--name:<VALUE>", null, null, "name", "VALUE")]
	[InlineData("--name=<VALUE>", null, null, "name", "VALUE")]
	[InlineData("-a:<VALUE> --name:<VALUE>", "a", null, "name", "VALUE")]
	[InlineData("-a=<VALUE> --name=<VALUE>", "a", null, "name", "VALUE")]
	public void ItParsesSingleValueTemplate(string template, string shortName, string symbolName, string longName, string valueName)