jerriep - dotnet-outdated 1.1.0

Package Description

PM> Install-Package dotnet-outdated -Version 1.1.0 -Source https://www.myget.org/F/jerriep/api/v3/index.json

Copy to clipboard

> nuget.exe install dotnet-outdated -Version 1.1.0 -Source https://www.myget.org/F/jerriep/api/v3/index.json

Copy to clipboard

> dotnet add package dotnet-outdated --version 1.1.0 --source https://www.myget.org/F/jerriep/api/v3/index.json

Copy to clipboard
<PackageReference Include="dotnet-outdated" Version="1.1.0" />
Copy to clipboard
source https://www.myget.org/F/jerriep/api/v3/index.json

nuget dotnet-outdated  ~> 1.1.0
Copy to clipboard

> choco install dotnet-outdated --version 1.1.0 --source https://www.myget.org/F/jerriep/api/v2

Copy to clipboard
Import-Module PowerShellGet
Register-PSRepository -Name "jerriep" -SourceLocation "https://www.myget.org/F/jerriep/api/v2"
Install-Module -Name "dotnet-outdated" -RequiredVersion "1.1.0" -Repository "jerriep" 
Copy to clipboard

dotnet-outdated

AppVeyor build status

NuGet MyGet

Overview

When using an IDE such as Visual Studio, it is easy to find out whether newer versions of the NuGet packages used by your project is available, by using the NuGet Package Manager. However, the .NET Core command-line tools do not provide a built-in way for you to report on outdated NuGet packages.

dotnet-outdated is a .NET Core Global tool that allows you to quickly report on any outdated NuGet packages in your .NET Core and .NET Standard projects.

Installation

Download and install the .NET Core 2.1 SDK or newer. Once installed, run the following command:

dotnet tool install --global dotnet-outdated

If you already have a previous version of dotnet-outdated installed, you can upgrade to the latest version using the following command:

dotnet tool update --global dotnet-outdated

Usage

Usage: dotnet outdated [arguments] [options]

Arguments:
  Path                                       The path to a .sln, .csproj or .fsproj file, or to a directory containing a .NET Core solution/project. If none is specified, the current directory will be used.

Options:
  --version                                  Show version information
  -?|-h|--help                               Show help information
  -i|--include-auto-references               Specifies whether to include auto-referenced packages.
  -pre|--pre-release <PRERELEASE>            Specifies whether to look for pre-release versions of packages. Possible values: Auto (default), Always or Never.
  -vl|--version-lock <VERSION_LOCK>          Specifies whether the package should be locked to the current Major or Minor version. Possible values: None (default), Major or Minor.
  -t|--transitive                            Specifies whether it should detect transitive dependencies.
  -td|--transitive-depth <TRANSITIVE_DEPTH>  Defines how many levels deep transitive dependencies should be analyzed. Integer value (default = 1)
  -u|--upgrade:<TYPE>                        Specifies whether outdated packages should be upgraded. Possible values for <TYPE> is Auto (default) or Prompt.
  -f|--fail-on-updates                       Specifies whether it should return a non-zero exit code when updates are found.
  -inc|--include <FILTER_INCLUDE>            Specifies to only look at packages where the name contains the provided string.
  -exc|--exclude <FILTER_EXCLUDE>            Specifies to only look at packages where the name does not contain the provided string.
  -o|--output <OUTPUT_FILENAME>              Specifies the filename for a generated report. (Use the -of|--output-format option to specify the format. JSON by default.)
  -of|--output-format <OUTPUT_FILE_FORMAT>   Specifies the output format for the generated report. Possible values: json (default) or csv.```

Screenshot of dotnet-outdated

Specifying the path

You can run dotnet-outdated without specifying the Path argument. In this case, it will look in the current directory for a solution (.sln) and if one is found it will analyze that solution. If no solution is found it will look for a project (.csproj or .fsproj) and if one is found it will analyze that project. If more than one solution or project is found in the current folder, dotnet-outdated will report an error.

You can also pass a directory in the Path argument, in which case the same logic described above will be used, but in the directory specified.

Lastly, you can specify the path to a solution (.sln) or project (.csproj or .fsproj) which dotnet-outdated must analyze.

Upgrading packages

dotnet-outdated can automatically attempt to upgrade any outdated packages to the latest version by passing the -u|--upgrade option. You can let dotnet-outdated prompt you for each outdated package by using the -u:prompt option.

Working with secure feeds

dotnet-outdated supports secure NuGet feeds, such as MyGet. It is suggested that you add these to your sources using the source command of the NuGet CLI. For secure feeds, you can either add a pre-authenticated URL or you can specify the username and password for the feed using the -UserName and -Password options of the nuget sources command.

dotnet-outdated supports computer-level, user-level and project-level configuration files.

Issues on macOS

In my testing, I ran into issues on macOS where the location of the user-level configuration file was not detected correctly. If you run into problems where dotnet-outdated does not appear to pick up your feeds correctly, please add the source to a project-level configuration file.

Also, on macOS and Linux, the password needs to be stored in clear text. You can do this by passing the -StorePasswordInClearText option to the nuget sources command.

Handling pre-release versions

dotnet-outdated allows you to specify whether to use pre-release versions of packages or not by passing the -pre|--pre-release option.

The default value of Auto will determine whether to use pre-release versions of a package based on whether the referenced version itself is a pre-release version. If the referenced version is a pre-release version, dotnet-outdated will include newer pre-release versions of the package. If the referenced version is not a pre-release version, dotnet-outdated will ignore pre-release versions.

You can also tell dotnet-outdated to always include pre-release versions by passing the Always value for this option. Conversely, you can tell it to never include pre-release versions by passing the Never value.

Locking to the current major or minor release

dotnet-outdated allows you to lock the version to the current major or minor version by passing the -vl|--version-lock option.

The default value of None will return the absolute latest package, regardless of whether it is a major or minor version upgrade.

Passing a value of Major will only report on later packages in the current major version range. For example, if the current version for a package is 4.1.0, dotnet-outdated will only report on later packages in the 4.x version range.

Passing a value of Minor will only report on later packages in the current minor version range. For example, if the current version for a package is 4.1.0, dotnet-outdated will only report on later packages in the 4.1.x version range.

Reporting on transitive dependencies

dotnet-outdated supports reporting on transitive dependencies as well. These are NuGet packages on which the NuGet packages directly referenced by your application depends. To enable reporting on transitive dependencies, you can pass the -t|--transitive option.

Screenshot of analysing transitive-dependencies

You can also specify how many levels deep it should analyze transitive dependencies with the -td|--transitive-depth option. You can pass an integer value for this option (the default value is 1).

Be careful with these options!. If you try and analyze dependencies too many levels deep, the analysis can take a very long time.

Failing when updates are available

dotnet-outdated can be easily incorporated into your build process. You can optionally enable a non-zero return code when updates are found to make failing a build easy to configure. To enable this option you can pass the -f|--fail-on-updates option.

Auto-references

Before version 1.2 of dotnet-outdated, it used to include automatically references packages in the output. The automatically referenced packages are typically your framework packages, such as Microsoft.NETCore.App or NETStandard.Library. It does not make sense reporting on these as outdated since you should target a new framework to have these updated.

From version 1.2, if you want these packages reported, you can pass the -i|--include-auto-references option. These packages will also be denoted with the text [A] appearing in the output after the package name.

Saving results to a file

You can save the results of dotnet-outdated to a file by specifying the name of an output file using the -o|--output option. By default, the results will be saved in JSON format. You can specify an alternate format using the -of|--output-format option.

Including and excluding packages

You can choose to include only specific packages by using the -inc|--include option. Only packages whose name contain the specified value will be included. For example, if you only want to analyze packages containing the value "microsoft", you can use the command dotnet outdated --include microsoft.

Conversely, you can exclude specific packages by using the -exc|--exclude option. In this case all packages will be analyzed except packages whose name contain the specified value. For example, if you want to exclude packages containing the value "microsoft", you can use the command dotnet outdated --exclude microsoft

FAQ

Why are the line endings in .csproj files changed to LF when running with -u?

This is due to a bug in MSBuild.

Why are unrelated changes made to .csproj files when running with -u?

dotnet-outdated does not make any changes to .csproj files directly. Instead, it runs dotnet add package to update packages, so that command is responsible for all changes made. To track issues related to this command, head over to the .NET CLI repo

Why I am getting an error about required library hostfxr.dll/libhostfxr.so/libhostfxr.dylib not found?

If you download the .NET Core CLI as a .zip/.tar.gz and extract it to a non default location, then you may encounter this error after installing and launching dotnet-outdated.

You can fix this error by setting the DOTNET_ROOT environment variable to point to the location of your .NET Core CLI installation. For more information, please refer to this blog post.

  • .NETCoreApp 2.1
  • .NETCoreApp 2.1: 2.1.0.0

Owners

Jerrie Pelser

Authors

Jerrie Pelser

Project URL

https://github.com/jerriep/dotnet-outdated

License

MIT

Info

437 total downloads
3 downloads for version 1.1.0
Download (1.13 MB)
Found on the current feed only

Package history

Version Size Last updated Downloads Mirrored?
2.3.0-pre.229 1.21 MB Sat, 15 Dec 2018 01:25:49 GMT 0
2.3.0-pre.226 1.21 MB Mon, 10 Dec 2018 12:32:52 GMT 0
2.3.0-pre.222 1.21 MB Wed, 05 Dec 2018 23:30:49 GMT 0
2.3.0-pre.220 1.21 MB Wed, 05 Dec 2018 09:04:34 GMT 0
2.2.0 1.21 MB Wed, 05 Dec 2018 08:53:30 GMT 2
2.2.0-rtm.218 1.21 MB Wed, 05 Dec 2018 08:46:22 GMT 2
2.2.0-rtm.217 1.21 MB Wed, 05 Dec 2018 08:17:53 GMT 1
2.2.0-rtm.216 1.21 MB Wed, 05 Dec 2018 08:01:31 GMT 2
2.2.0-pre.215 1.21 MB Wed, 05 Dec 2018 07:35:02 GMT 1
2.2.0-pre.214 1.21 MB Wed, 05 Dec 2018 04:12:29 GMT 0
2.2.0-pre.212 1.21 MB Wed, 05 Dec 2018 03:56:34 GMT 0
2.2.0-pre.210 1.21 MB Wed, 05 Dec 2018 02:09:03 GMT 0
2.2.0-pre.209 1.21 MB Wed, 05 Dec 2018 02:07:51 GMT 1
2.2.0-pre.201 1.21 MB Sat, 01 Dec 2018 01:40:24 GMT 0
2.2.0-pre.199 1.21 MB Tue, 27 Nov 2018 23:34:27 GMT 0
2.2.0-pre.197 1.2 MB Wed, 21 Nov 2018 23:58:53 GMT 0
2.2.0-pre.195 1.2 MB Wed, 21 Nov 2018 00:12:45 GMT 0
2.2.0-pre.193 1.2 MB Sun, 18 Nov 2018 03:44:08 GMT 0
2.2.0-pre.192 1.15 MB Wed, 07 Nov 2018 10:41:29 GMT 1
2.2.0-pre.191 1.15 MB Sun, 04 Nov 2018 12:57:34 GMT 3
2.2.0-pre.190 1.15 MB Sun, 04 Nov 2018 09:52:13 GMT 1
2.2.0-pre.189 1.15 MB Sat, 03 Nov 2018 07:45:58 GMT 1
2.2.0-pre.188 1.15 MB Sat, 03 Nov 2018 02:03:44 GMT 1
2.2.0-pre.187 1.15 MB Sat, 03 Nov 2018 00:54:05 GMT 0
2.2.0-pre.186 1.15 MB Sat, 03 Nov 2018 00:46:14 GMT 1
2.2.0-pre.184 1.15 MB Tue, 30 Oct 2018 13:51:00 GMT 1
2.2.0-pre.182 1.14 MB Tue, 30 Oct 2018 08:18:25 GMT 2
2.2.0-pre.181 1.14 MB Mon, 29 Oct 2018 23:32:52 GMT 0
2.2.0-pre.179 1.14 MB Mon, 29 Oct 2018 23:18:56 GMT 1
2.2.0-pre.173 1.14 MB Sun, 28 Oct 2018 01:35:33 GMT 2
2.2.0-pre.171 1.14 MB Sat, 27 Oct 2018 04:09:07 GMT 1
2.2.0-pre.170 1.14 MB Sat, 27 Oct 2018 03:21:09 GMT 1
2.1.0 1.14 MB Sat, 27 Oct 2018 03:07:32 GMT 2
2.1.0-rtm.168 1.14 MB Sat, 27 Oct 2018 03:01:16 GMT 2
2.1.0-pre.167 1.14 MB Sat, 27 Oct 2018 02:50:29 GMT 2
2.1.0-pre.166 1.14 MB Sat, 27 Oct 2018 02:46:16 GMT 2
2.1.0-pre.165 1.14 MB Sat, 27 Oct 2018 02:31:31 GMT 1
2.1.0-pre.164 1.14 MB Sat, 27 Oct 2018 02:23:53 GMT 1
2.1.0-pre.160 1.14 MB Tue, 23 Oct 2018 01:20:03 GMT 1
2.1.0-pre.158 1.14 MB Tue, 23 Oct 2018 00:32:40 GMT 3
2.1.0-pre.155 1.14 MB Thu, 18 Oct 2018 15:11:23 GMT 1
2.1.0-pre.154 1.14 MB Tue, 16 Oct 2018 04:05:54 GMT 2
2.1.0-pre.152 1.14 MB Tue, 16 Oct 2018 00:04:50 GMT 1
2.1.0-pre.148 1.14 MB Wed, 10 Oct 2018 23:50:07 GMT 4
2.1.0-pre.146 1.14 MB Wed, 10 Oct 2018 23:38:43 GMT 1
2.1.0-pre.145 1.14 MB Wed, 10 Oct 2018 23:37:32 GMT 4
2.1.0-pre.141 1.14 MB Mon, 08 Oct 2018 23:08:26 GMT 2
2.1.0-pre.139 1.14 MB Mon, 08 Oct 2018 23:02:56 GMT 3
2.1.0-pre.136 1.14 MB Mon, 08 Oct 2018 08:30:44 GMT 1
2.1.0-pre.134 1.14 MB Mon, 08 Oct 2018 08:27:29 GMT 3
2.1.0-pre.132 1.14 MB Mon, 08 Oct 2018 08:20:11 GMT 2
2.1.0-pre.128 1.14 MB Sun, 07 Oct 2018 02:23:49 GMT 1
2.1.0-pre.115 1.14 MB Wed, 12 Sep 2018 06:35:43 GMT 5
2.1.0-pre.114 1.14 MB Wed, 12 Sep 2018 06:34:39 GMT 3
2.1.0-pre.112 1.14 MB Wed, 12 Sep 2018 05:24:35 GMT 2
2.1.0-pre.106 1.14 MB Mon, 03 Sep 2018 10:20:21 GMT 3
2.1.0-pre.104 1.14 MB Mon, 03 Sep 2018 10:13:50 GMT 5
2.1.0-pre.102 1.14 MB Mon, 13 Aug 2018 03:39:28 GMT 4
2.1.0-pre.101 1.14 MB Mon, 13 Aug 2018 03:38:44 GMT 1
2.1.0-pre.98 1.14 MB Thu, 02 Aug 2018 00:24:13 GMT 3
2.1.0-pre.96 1.14 MB Fri, 20 Jul 2018 12:33:31 GMT 6
2.1.0-pre.95 1.14 MB Wed, 18 Jul 2018 12:38:13 GMT 5
2.0.0 1.14 MB Wed, 18 Jul 2018 08:55:58 GMT 5
2.0.0-rtm.93 1.14 MB Wed, 18 Jul 2018 08:53:59 GMT 3
2.0.0-pre.92 1.14 MB Wed, 18 Jul 2018 08:26:44 GMT 6
2.0.0-pre.91 1.14 MB Wed, 18 Jul 2018 08:20:24 GMT 5
2.0.0-pre.90 1.14 MB Wed, 18 Jul 2018 05:07:05 GMT 9
2.0.0-pre.89 1.14 MB Wed, 18 Jul 2018 04:09:39 GMT 7
2.0.0-pre.85 1.14 MB Tue, 17 Jul 2018 09:00:44 GMT 5
2.0.0-pre.84 1.14 MB Tue, 17 Jul 2018 07:29:49 GMT 5
2.0.0-pre.82 1.13 MB Tue, 17 Jul 2018 04:30:56 GMT 4
1.4.0-pre.80 1.13 MB Wed, 11 Jul 2018 02:08:38 GMT 3
1.4.0-pre.79 1.13 MB Wed, 11 Jul 2018 02:01:34 GMT 4
1.4.0-pre.76 1.13 MB Tue, 10 Jul 2018 04:27:24 GMT 6
1.4.0-pre.75 1.13 MB Fri, 06 Jul 2018 08:27:25 GMT 7
1.3.0 1.13 MB Fri, 06 Jul 2018 08:16:09 GMT 9
1.3.0-rtm.73 1.13 MB Fri, 06 Jul 2018 08:11:17 GMT 6
1.3.0-pre.72 1.13 MB Fri, 06 Jul 2018 06:16:23 GMT 7
1.3.0-pre.71 1.13 MB Fri, 06 Jul 2018 04:54:13 GMT 4
1.3.0-pre.70 1.13 MB Fri, 06 Jul 2018 04:25:59 GMT 8
1.3.0-pre.68 1.13 MB Fri, 06 Jul 2018 03:59:41 GMT 2
1.3.0-pre.67 1.13 MB Fri, 06 Jul 2018 03:57:16 GMT 5
1.3.0-pre.66 1.13 MB Fri, 06 Jul 2018 03:56:27 GMT 5
1.3.0-pre.62 1.13 MB Thu, 21 Jun 2018 06:01:02 GMT 2
1.2.0 1.13 MB Thu, 21 Jun 2018 05:10:14 GMT 4
1.2.0-rtm.60 1.13 MB Thu, 21 Jun 2018 05:05:56 GMT 4
1.2.0-pre.59 1.13 MB Thu, 21 Jun 2018 04:01:40 GMT 4
1.2.0-pre.58 1.13 MB Thu, 21 Jun 2018 03:52:37 GMT 6
1.2.0-pre.57 1.13 MB Wed, 20 Jun 2018 10:11:27 GMT 6
1.2.0-pre.56 1.13 MB Wed, 20 Jun 2018 08:54:53 GMT 4
1.2.0-pre.55 1.13 MB Wed, 20 Jun 2018 05:36:46 GMT 7
1.2.0-pre.54 1.13 MB Wed, 13 Jun 2018 04:09:11 GMT 5
1.1.0 1.13 MB Wed, 13 Jun 2018 04:05:00 GMT 3
1.1.0-rtm.52 1.13 MB Wed, 13 Jun 2018 03:56:54 GMT 6
1.1.0-pre.51 1.13 MB Wed, 13 Jun 2018 03:26:50 GMT 4
1.1.0-pre.50 1.13 MB Wed, 13 Jun 2018 03:10:13 GMT 5
1.1.0-pre.49 1.13 MB Tue, 12 Jun 2018 04:06:01 GMT 3
1.1.0-pre.48 1.13 MB Mon, 11 Jun 2018 08:48:25 GMT 5
1.1.0-pre.47 1.13 MB Mon, 11 Jun 2018 08:26:34 GMT 3
1.1.0-pre.46 1.13 MB Fri, 08 Jun 2018 08:04:15 GMT 4
1.1.0-pre.44 1.13 MB Thu, 07 Jun 2018 08:31:46 GMT 3
1.1.0-pre.43 1.13 MB Thu, 07 Jun 2018 08:06:19 GMT 5
1.1.0-pre.36 1.12 MB Wed, 06 Jun 2018 00:40:29 GMT 11
1.1.0-pre.35 1.12 MB Sun, 03 Jun 2018 07:11:57 GMT 4
1.1.0-pre.33 1.12 MB Thu, 31 May 2018 03:21:54 GMT 6
1.0.0 1.12 MB Thu, 31 May 2018 03:17:51 GMT 4
1.0.0-rtm.31 1.12 MB Thu, 31 May 2018 03:16:01 GMT 3
1.0.0-rtm.30 1.12 MB Thu, 31 May 2018 02:45:15 GMT 5
0.3.0 1.12 MB Mon, 28 May 2018 08:56:44 GMT 7
0.3.0-rtm.28 1.12 MB Mon, 28 May 2018 08:54:48 GMT 3
0.3.0-pre.27 1.12 MB Mon, 28 May 2018 08:11:37 GMT 4
0.3.0-pre.26 1.12 MB Mon, 28 May 2018 04:55:13 GMT 5
0.3.0-pre.25 1.12 MB Mon, 28 May 2018 04:45:48 GMT 3
0.3.0-pre.23 1.12 MB Fri, 25 May 2018 06:43:56 GMT 3
0.3.0-pre.22 1.12 MB Fri, 25 May 2018 02:24:48 GMT 5
0.3.0-pre.21 1.12 MB Thu, 24 May 2018 13:57:00 GMT 6
0.3.0-pre.20 1.12 MB Thu, 24 May 2018 08:14:38 GMT 2
0.3.0-pre.19 1.12 MB Thu, 24 May 2018 05:08:47 GMT 3
0.3.0-pre.18 1.12 MB Thu, 24 May 2018 04:34:53 GMT 4
0.3.0-pre.17 1.12 MB Thu, 24 May 2018 04:32:08 GMT 6
0.3.0-pre.15 3.42 MB Fri, 18 May 2018 09:20:16 GMT 3
0.2.0 3.42 MB Fri, 18 May 2018 09:04:06 GMT 5
0.2.0-rtm.13 3.42 MB Fri, 18 May 2018 09:01:40 GMT 3
0.2.0-pre.12 3.42 MB Fri, 18 May 2018 07:43:00 GMT 5
0.2.0-pre.11 3.42 MB Fri, 18 May 2018 06:48:26 GMT 5
0.2.0-pre.10 3.42 MB Fri, 18 May 2018 06:44:34 GMT 3
0.2.0-pre.9 3.42 MB Fri, 18 May 2018 06:26:55 GMT 2
0.2.0-pre.8 3.42 MB Fri, 18 May 2018 06:14:54 GMT 5
0.1.0 3.42 MB Thu, 17 May 2018 04:01:42 GMT 4
0.1.0-rtm.7 3.42 MB Thu, 17 May 2018 11:58:37 GMT 3
0.1.0-rtm.4 3.42 MB Thu, 17 May 2018 03:25:32 GMT 6
0.1.0-pre.3 3.42 MB Thu, 17 May 2018 03:03:08 GMT 3
0.1.0-pre.2 3.42 MB Thu, 17 May 2018 02:57:36 GMT 7