NugetVersion 1.0.12

NugetVersion .NET Core Global tool

.NET Core Global Tool for querying and updating Nuget project versions across multiple projects within a directory

<a name="dotnet-nugetversion-tool"></a> Global tool for .NET 6.x+ and later

.NET 6.x+ is required for global tools, meaning that you can install nugetversion using the .NET CLI and use it everywhere.

⚠️ To use global tools, .Net Core SDK 2.1.300 or later is required.

Install nugetversion as a global tool first time

dotnet tool install -g nugetversion [--version version]

Update nugetversion to the latest, or specified

dotnet tool update -g nugetversion

Uninstall

dotnet tool uninstall nugetversion

Query

From this point on, you can run the following to query all projects for nuget package references, with optional name and version filtering

nugetversion src-dir-to-project-folders [-n|--name nameSpec] [-v|--version versionSpec] [-o filepath] [-of json] [-fw targetFramework]

• nameSpec can be a wildcard search like *something*
• versionSpec can be a wildcard search, eg 1.*.0

Arguments

• -n nameSpec - nuget name filter with wildcards ie -n Microsoft.*
• -v versionSpec - version filter ie -v 1.0.*
• -o filepath - output results to file -o somefile.txt, now with -of flag this would suit -of somefile.json
• -of output-format - format to output, ie -of json to output json, combine with -o flag to write file
• -fw targetFramework - filter by target framework, ie -fw net5.0

Update Versions

To update versions for a specific query, specify the --set-version <VERSION> switch, this uses the internal .NET core package command so is generally safe to use, however just be aware it will update according to the query you specify.

This will show a list of items to be updated, and will prompt before starting the update process.

nugetversion src-dir-to-project-folders [-n|--name nameSpec] [-v|--version versionSpec] --set-version x.x.x

WARNING: this will update ALL project file(s) and projects that match that criteria to the specific version specified if that version is available for that package.

Releases at releases.md