Show enum values as argument in help text

[kbilsted]

When options or arguments are parsed into an enum, the help text will now include the values contained in the enum.

fixes #92

[natemcmaster]

This is a good start! I made a few suggestions below, but overall I like it. The approach here is simple and clean. Thanks!

I suspect this doesn't work on attributes? Have you tried it on a small program like this?

enum Color { Red, Blue }
class Program
{
  [Option]
  public Color Color { get; }
}

[natemcmaster]

Also, it looks like there are some test failures on Linux. It looks to me like the HangingIndentWriter is adding new lines, possibly because it is detecting Console.BufferWidth as a small number, or because it's failing altogether and defaulting to 80. Might be good to see if we can write a test what won't change its results based on the size of the console used to launch the test.

Relevant code to look at:

CommandLineUtils/src/CommandLineUtils/HelpText/DefaultHelpTextGenerator.cs

Lines 313 to 329 in 76413af

	/// <summary>
	/// Get the Console width.
	/// </summary>
	/// <returns>BufferWidth or the default.</returns>
	private int? TryGetConsoleWidth()
	{
	try
	{
	return Console.BufferWidth;
	}
	catch (IOException)
	{
	// If there isn't a console - for instance in test enviornments
	// An IOException will be thrown trying to get the Console.BufferWidth.
	return null;
	}
	}

CommandLineUtils/src/CommandLineUtils/HelpText/HangingIndentWriter.cs

Lines 16 to 34 in 76413af

	/// <summary>
	/// The default console width used for wrapping if the width cannot be gotten from the Console.
	/// </summary>
	public const int DefaultConsoleWidth = 80;
	private readonly bool _indentFirstLine;
	private readonly int _indentSize;
	private readonly int _maxLineLength;
	private readonly string _paddedLine;
	/// <summary>
	/// A description formatter for dynamically wrapping the description to print in a CLI usage.
	/// </summary>
	/// <param name="indentSize">The indent size in spaces to use.</param>
	/// <param name="maxLineLength">The max length an indented line can be.
	/// Defaults to <see cref="DefaultConsoleWidth"/>.
	/// </param>
	/// <param name="indentFirstLine">If true, the first line of text will also be indented.</param>
	public HangingIndentWriter(int indentSize, int? maxLineLength = null, bool indentFirstLine = false)

[kbilsted]

PR ready for review again

[natemcmaster]

Thanks for updating! I had a just a few more comments to address about the new public APIs added. Once addressed, I’ll merge this in. I’m planning for this to be part of 2.5, planning to release in a few weeks.