ConsoleToolkit 2.0.0

.NET Standard 2.0
dotnet add package ConsoleToolkit --version 2.0.0
NuGet\Install-Package ConsoleToolkit -Version 2.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ConsoleToolkit" Version="2.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ConsoleToolkit --version 2.0.0
#r "nuget: ConsoleToolkit, 2.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install ConsoleToolkit as a Cake Addin
#addin nuget:?package=ConsoleToolkit&version=2.0.0

// Install ConsoleToolkit as a Cake Tool
#tool nuget:?package=ConsoleToolkit&version=2.0.0

The Console Toolkit is a sophisticated but simple to learn library providing a full set of features for building console applications. It focuses on getting out of the way as quickly as possible so that you can get on with implementing functionality without having to deal with the complications of parsing command line options, parsing user input, or formatting console output in a comprehensible format.

The library includes a declaritive mechanism for specifying command line options. You can specify your commands and options in a clear and simple way and the Toolkit will take care of the validation. You simply declare a handler and the library will call it if the user specifies valid parameters.

Applications that accept multiple commands are fully supported, and the Toolkit even allows you to offer your users an interactive session in which they can issue commands into a custom command line interface. This functionality is provided free, you just need to start the session and define a command to allow the user to exit the session.

Command and command option help is provided automatically. You just need to tell the toolkit which option or command invokes the help text, and your user will be shown syntax and options. If you use the [Description(...)] attribute, your descriptions will automatically formatted and incorporated in the help text.

Command output can be formatted using a custom wrapper over the standard .NET Console object. To access this object you only need to add a parameter of type IConsoleAdapter and you can access features such as tabular data formatting and word wrapping. Colour support is provided through extension methods, so that you can specify .Red(), .Green() etc and the toolkit will worry about switching the Console output colour intelligently on your behalf.

If you need to capture console input from the user, the library provides an input parsing mechanism that supports everything from simple confirmation requests to compound data structures. The library will validate the user's input and provide you with .NET types so that you don't have to parse the strings yourself.

Comprehensive library documentation is available from the project website, but the library has been designed to be unobtrusive and straightforward to use. Follow the getting started guide to get a fully functional and well behaved console application up and running in minutes. You can even choose the parsing standard you prefer. If you want your commands to use DOS convetions, Unix conventions or the current Windows command line conventions, you just select an option and the Toolkit will format your help text and parse the user's arguments using the appropriate rules.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.0 6,979 8/26/2018
1.4.1 1,395 2/8/2018
1.4.0-beta3 1,007 12/31/2017
1.4.0-beta2 841 11/23/2017
1.4.0-beta1 1,039 11/19/2017
1.3.4 1,173 11/8/2017
1.3.3 1,164 11/3/2017
1.3.2 1,144 10/29/2017
1.3.1 1,043 9/23/2017
1.3.0-beta3 1,068 9/5/2017
1.3.0-beta2 966 8/20/2017
1.3.0-beta 849 8/20/2017
1.2.0 1,284 12/11/2016
1.2.0-beta3 954 12/10/2016
1.2.0-beta2 953 12/5/2016
1.2.0-beta 953 12/2/2016
1.1.0 1,283 6/27/2016
1.0.1 1,539 7/9/2015 1,381 7/4/2015 1,347 6/19/2015 1,385 5/12/2015

Updated the library to be a netstandard2.0 library. A later release will target an earlier netstandard version, but changes to the library will be required in order to achieve that. Version 1.4.1 will be the last version of the library compatible with .NET 4.0, but I hope to add compatibility with earlier versions than 4.7.1, which is currently the required full framework version.