loic-sharma / nuclear

Delete NuGet packages quickly

Nuclear ⚛️

Does your NuGet package have too many versions? Do you want to bulk delete or unlist them? Do it quickly using Nuclear!

Installation

You can install nuclear as a .NET tool:

dotnet tool install --global nuget-clear --version 1.0.0-preview1

Examples

Let's find some versions of your package to delete on nuget.org:

nuclear list My.Package

Too many results? Try filtering the package list using floating version notation:

nuclear list My.Package 1.1.*

Let's nuke some packages! 🤯

nuclear delete My.Package 2.0.0-* --api-key NUGET_API_KEY

This unlists pre-releases of My.Package v2.0.0 on nuget.org.

You can create API keys on nuget.org using this documentation. Make sure to select the Unlist package scope when creating your API key.

Concepts

Deleting vs unlisting

NuGet servers are free to interpret "delete" operations. For example, nuget.org unlists packages to prevent the "left-pad problem". Unlisted packages are undiscoverable on nuget.org and can be re-listed in the future.

However, private NuGet servers like BaGet can be configured to delete packages. You may not be able to undo a package deletion, so be careful!

Version ranges

NuGet packages use semantic versioning which has the form Major.Minor.Patch[-PreleaseLabel]. A package is considered pre-release if it has a pre-release label, or stable otherwise. For example, version 1.0.0-preview is a pre-release, but version 1.0.0 is stable.

Nuclear supports floating notation. For example:

Version range	Matches	Ignores	Notes
1.0.0	1.0.0	2.0.0	Exact version match
1.0.*	1.0.0, 1.0.1	1.1.0, 2.0.0, 1.0.0-prerelease	Excludes pre-releases
1.*	1.0.0, 1.2.0	2.0.0, 1.0.0-prerelease	Excludes pre-releases
*	0.0.0, 1.2.3	1.0.0-prerelease	Matches all stable versions
1.0.0-*	1.0.0-alpha, 1.0.0-beta	1.0.0	Excludes stable releases
*-*	1.0.0-alpha, 3.4.5-beta	1.0.0	Matches all pre-release versions

Reference

nuclear list

Find package versions. Usage:

nuclear list <PACKAGE> [VERSIONS] [OPTIONS]

Arguments:

• PACKAGE - The package ID whose versions should be listed.
• VERSIONS - Optional. Filters results using floating version notation.

Options:

• -s, --source - The NuGet package source URL. Defaults to https://api.nuget.org/v3/index.json.
• -o, --output - Set the output format. Allowed values are Allowed values are tty, or json.

nuclear delete

Delete package versions. Usage:

nuclear delete <PACKAGE> <VERSIONS> [OPTIONS]

Arguments:

• PACKAGE - The package ID whose versions should be deleted.
• VERSIONS - The version range that should be deleted using floating version notation.

Options:

• -s, --source - The NuGet package source URL. Defaults to https://api.nuget.org/v3/index.json.
• -k, --api-key - The API key to authenticate on the package source.
• --dry-run - Show what would be deleted.

nuclear's Issues

Add number of matches to console output