This project is read-only.

Ookii.CommandLine 2.1

Rating: No reviews yet
Downloads: 87
Change Set: 12578
Released: Feb 19, 2012
Updated: Feb 19, 2012 by SvenGroot
Dev status: Stable Help Icon

Recommended Download

Application Ookii.CommandLine 2.1
application, 623K, uploaded Feb 19, 2012 - 87 downloads

Release Notes

This release includes several improvements, including dictionary arguments, improved support for multi-value arguments, custom per-argument type converters, and several bug fixes.

Release contents
This release contains the following:
  • Ookii.CommandLine.dll: the class library binary that you can use with your own applications targetting the Microsoft .Net Framework 2.0 or later (Mono 2.6 or later is also supported).
  • User Guide.html: documentation for this release (also available under Documentation).
  • Documentation.chm: class library documentation for this release
  • The full source code to the Ookii.CommandLine library.
  • Two sample applications (including source code in C# and VB) demonstrating command line argument parsing and shell commands.

What's new
Ookii.CommandLine 2.1 offers the following improvements over version 2.0:
  • Added support for dictionary arguments; these are special multi-value arguments whose values take the form key=value.
  • Multi-value arguments can be specified using a read-only property of any collection type (in addition to the previous array support).
  • Multi-value properties can optionally use a separator character to allow multiple values to be specified without specifying the argument multiple times.
  • Added support for specifying a custom type converter for individual arguments.
  • When specifying the default value for an argument defined by a property you can now use any type that can be converted to the argument’s type using its type converter. This makes it possible to define default values for arguments with a type for which there are no literals.
  • A CommandLineArgumentException is thrown when the argument type’s constructor or a property setter throws an exception (instead of a TargetInvocationException).
  • The CommandLineParser no longer sets the property value for an unspecified argument with a default value of null.
  • Shell commands can take their name from the type name.
  • Shell commands can use custom argument parsing.
  • Various minor bug fixes.

Upgrading from Ookii.CommandLine 1.0
Ookii.CommandLine 2.0 and newer version have substantial changes from version 1.0 and are not designed to be backwards compatible. There are changes in argument parsing behavior and API names and usage.

Upgrading an existing project that is using Ookii.CommandLine 1.0 to Ookii.CommandLine 2.0 or newer may require substantial code changes and may change how command lines are parsed.

Reviews for this release

No reviews yet for this release.