Knapcode.PackageLifeCycle 0.1.0-beta.2

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
This is a prerelease version of Knapcode.PackageLifeCycle.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet tool install --global Knapcode.PackageLifeCycle --version 0.1.0-beta.2
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local Knapcode.PackageLifeCycle --version 0.1.0-beta.2
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Knapcode.PackageLifeCycle&version=0.1.0-beta.2&prerelease
nuke :add-package Knapcode.PackageLifeCycle --version 0.1.0-beta.2

Knapcode.PackageLifeCycle

A CLI tool to help you manage the lifecycle of published NuGet packages.

Right now, all it does is deprecates packages using a preview "deprecate" API on NuGet.org.

Install

dotnet tool install Knapcode.PackageLifeCycle --prerelease --global

Deprecate

Example

Note: The --api-key option is required when deprecating packages on NuGet.org.

Mark a specific version as having critical bugs with a message.

nuget-plc deprecate jQuery --version 3.5.0 --critical-bugs --message "Bad, bad bugs!"

Mark a specific range of versions as deprecated with an alternate.

nuget-plc deprecate NuGet.Core --range "[, 3.0.0)" --alternate-id NuGet.Protocol --message "Use this other thing."

Mark all versions as legacy.

nuget-plc deprecate jQuery --all --legacy

Help text

Description:
  Mark existing packages as deprecated.

Usage:
  nuget-plc deprecate <PACKAGE_ID> [options]

Arguments:
  <PACKAGE_ID>  The ID of the package that should be deprecated.

Options:
  --version <version>          A specific version to mark as deprecated (multiple allowed).
  --range <range>              A range of versions to mark as deprecated (multiple allowed).
  --all                        Deprecate all versions.
  --api-key <api-key>          The API key to use when deprecating the package.
  --legacy                     Mark the deprecated versions as legacy.
  --critical-bugs              Mark the deprecated versions as having critical bugs.
  --other-reason               Mark the deprecated versions as having some other deprecation
                               reason. Enabled by default if no other deprecation reason is
                               selected.
  --message <message>          A deprecation message to display. Required if --other-reason is
                               specified or no other deprecation reason is selected.
  --alternate-id <id>          An alternate package ID to recommend instead of this package.
  --alternate-version <ver>    A specific alternate package version to recommend. Only usable with
                               --alternate-id.
  --dry-run                    Runs the entire operation without actually submitting the
                               deprecation request.
  --overwrite                  Replace existing deprecation metadata on a package version.
  --allow-missing-versions     Allow deprecating versions that are not yet available on the source.
  --skip-validation            Skip as much validation as possible before submitting the request.
  --source <source>            The package source to use. [default:
                               https://api.nuget.org/v3/index.json]
  --package-publish-url <url>  The URL to use for the PackagePublish resource. Defaults to
                               discovering it from the --source option.
  --log-level <level>          The minimum log level to display. Possible values: Verbose, Debug,
                               Information, Warning, Error, Fatal [default: Information]
  -?, -h, --help               Show help and usage information
Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
0.1.0-beta.6 42 5/30/2024
0.1.0-beta.5 95 4/24/2024
0.1.0-beta.4 50 4/24/2024
0.1.0-beta.3 47 4/17/2024
0.1.0-beta.2 80 5/19/2023
0.1.0-beta.1 72 5/19/2023

Initial release with support for the deprecate command.