WGet.NET 3.2.0

WGet.NET

❓ What is WGet.NET

WGet.NET is a WinGet wrapper library for .Net.

I created it for another project and then made a library out of it in hope it might be usefull to someone else too.
If you tried this library, please give me some feedback. And if you miss a feature, you can create an issue to let me know.

📓 Documentation

https://basicx-strgv.github.io/WGet.NET/

⚡ Features

Supported Frameworks: .Net Core 3.1, .Net Standard 2.0

• WinGet
  • Get a list of installed packages
  • Search installed packages
  • Search packages
  • Install packages
  • Uninstall packages
  • Upgrade packages
  • Get a list of upgradeable packages
  • Export and Import packages
  • Check if WinGet is installed
  • Get the WinGet version number
  • Get installed sources
  • Add sources
  • Remove sources
  • Update sources
  • Export and Import sources
  • Reset sources
  • Calculate file hash
  • Export Settings
  • Download package installer
  • Manage pinned packages
  • Access info of the WinGet installation
• Other
  • Asynchronous Execution

📦 NuGet Package

You can get the NuGet package here: https://www.nuget.org/packages/WGet.NET/

❗ Requirements

WinGet needs to be installed on the system.

If WinGet is not installed on your system you can get it here: https://github.com/microsoft/winget-cli

💡 Getting started

The needed namespace is WGetNET (using WGetNET;).
This namespace contains the three classes, that are used to perform actions or get information with winget.

WinGetInfo:

The WinGetInfo class can be used to get information about WinGet itself.
This class is inherited by the WinGetPackageManager and WinGetSourceManager class.

USing this class to check if winget is installed could look like this:

WinGetInfo wingetInfo = new WinGetInfo();
if (wingetInfo.WinGetInstalled)
{
     Console.WriteLine("WinGet is installed.");
}
else
{
     Console.WriteLine("WinGet is NOT installed.");
}

WinGetPackageManager:

The WinGetPackageManager class is used for everything that has to do with packages.
It can install, remove, upgrade, search, list, export and import packages.

The code for installing a package could look like this:

WinGetPackageManager packageManager = new WinGetPackageManager();
packageManager.InstallPackage("Git.Git");

WinGetSourceManager:

The WinGetSourceManager class is used for everything that has to do with sources.
It can list, add, update, export, reset and remove sources.

To use the add, remove and reset functions, the process needs to have administrator privileges.
(WinGet can’t perform these actions without administrator privileges)

The code for adding a source could look like this:

WinGetSourceManager sourceManager = new WinGetSourceManager();
sourceManager.AddSource("msstore", "https://storeedgefd.dsx.mp.microsoft.com/v9.0", "Microsoft.Rest");

Find Latest Versions of a Package:

Using the WinGetPackageManager class you can use the GetInstalledPackages capability to get the latest version of a package and then retrieve the version number from the AvailableVersionObject property.

You would then be able to compare this to the current version of the package (VersionObject property) and determine if you need to notify users of an available upgrade.

WinGetPackageManager packageManager = new WinGetPackageManager();
string packageId = "nkdAgility.AzureDevOpsMigrationTools";
WinGetPackage package = packageManager.GetInstalledPackages(packageId, true).FirstOrDefault();

if (package.AvailableVersionObject > package.VersionObject)
{
    Console.WriteLine("You are currently running version {currentVersion} and a newer version ({latestVersion}) is available. You should update now using Winget command 'winget {packageId}' from the Windows Terminal.", currentPackageVersion, latestPackageVersion, packageId);
}