[Breaking change]: CommandLineUtils retired

[yecril71pl]

Description

The package CommandLineUtils was removed from ASP.NET 2.0.

The discussion issue was https://github.com/dotnet/extensions/issues/257.

This change was overlooked because we failed to follow breaking changes in extensions. It is important to document it here because it is not mentioned at 1.x to 2.0 either.

Version

Other (please put exact version in description textbox)

Previous behavior

using Microsoft.Extensions.CommandLineUtils;

New behavior

using McMaster.Extensions.CommandLineUtils;

Type of breaking change

• [ ] Binary incompatible: Existing binaries may encounter a breaking change in behavior, such as failure to load/execute or different run-time behavior.
• [X] Source incompatible: Source code may encounter a breaking change in behavior when targeting the new runtime/component/SDK, such as compile errors or different run-time behavior.

Reason for change

The library has outgrown the scope of the ASP.NET project where it had been developed.

Recommended action

Migration steps include the following alternatives:

• adapt your code to use system Command-line configuration provider
• adapt your code to use community CommandLine
• keep your code and switch to use 3rd-party CommandLineUtils fork

Affected APIs

The whole package CommandLineUtils is unsupported.