Merge pull request #26 from basicx-StrgV/develop

Merge Version 3.2.0 from develop to main

Author: basicx-StrgV

README.md

@@ -41,6 +41,7 @@ https://basicx-strgv.github.io/WGet.NET/
   - [x] Export Settings
   - [x] Download package installer
   - [x] Manage pinned packages
+  - [x] Access info of the WinGet installation
 - Other
   - [x] Asynchronous Execution
 
@@ -101,20 +102,16 @@ sourceManager.AddSource("msstore", "https://storeedgefd.dsx.mp.microsoft.com/v9.
 
 ### 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 `AvailableVersion` property.
+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 and determine if you need to notify users of an available upgrade.
+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.
 
 ```csharp
-Version currentPackageVersion = null;
-Version latestPackageVersion = null;
 WinGetPackageManager packageManager = new WinGetPackageManager();
 string packageId = "nkdAgility.AzureDevOpsMigrationTools";
-var package = packageManager.GetInstalledPackages(packageId, true).FirstOrDefault();
-currentPackageVersion = new Version(package.Version);
-latestPackageVersion = new Version(package.AvailableVersion);
+WinGetPackage package = packageManager.GetInstalledPackages(packageId, true).FirstOrDefault();
 
-if (latestPackageVersion > currentPackageVersion)
+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);
 }

docs/annotated.html

@@ -25,7 +25,7 @@
  <tbody>
  <tr id="projectrow">
   <td id="projectalign">
-   <div id="projectname">WGet.NET<span id="projectnumber">&#160;3.1.0</span>
+   <div id="projectname">WGet.NET<span id="projectnumber">&#160;3.2.0</span>
    </div>
    <div id="projectbrief">A WinGet wrapper library for .Net.</div>
   </td>
@@ -95,16 +95,19 @@
 <div class="contents">
 <div class="textblock">Here are the classes, structs, unions and interfaces with brief descriptions:</div><div class="directory">
 <div class="levels">[detail level <span onclick="javascript:toggleLevel(1);">1</span><span onclick="javascript:toggleLevel(2);">2</span>]</div><table class="directory">
-<tr id="row_0_" class="even"><td class="entry"><span style="width:0px;display:inline-block;">&#160;</span><span id="arr_0_" class="arrow" onclick="toggleFolder('0_')">&#9660;</span><span class="icona"><span class="icon">N</span></span><a class="el" href="d3/d8b/a00059.html" target="_self">WGetNET</a></td><td class="desc"></td></tr>
-<tr id="row_0_0_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d9/dec/a00090.html" target="_self">WinGetActionFailedException</a></td><td class="desc">Exception that gets thrown if a winget action failed </td></tr>
-<tr id="row_0_1_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="dc/d54/a00094.html" target="_self">WinGetFeatureNotSupportedException</a></td><td class="desc">Exception that gets thrown if a winget feature is not supportet in the installed winget version </td></tr>
-<tr id="row_0_2_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d9/da4/a00078.html" target="_self">WinGetInfo</a></td><td class="desc">The <a class="el" href="d9/da4/a00078.html" title="The WGetNET.WinGetInfo class offers informations about the installed winget version.">WGetNET.WinGetInfo</a> class offers informations about the installed winget version </td></tr>
-<tr id="row_0_3_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d1/d44/a00098.html" target="_self">WinGetNotInstalledException</a></td><td class="desc">Exception that gets thrown if winget is not installed </td></tr>
-<tr id="row_0_4_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d7/d12/a00126.html" target="_self">WinGetPackage</a></td><td class="desc">Represents a winget package </td></tr>
-<tr id="row_0_5_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d4/d63/a00082.html" target="_self">WinGetPackageManager</a></td><td class="desc">The <a class="el" href="d4/d63/a00082.html" title="The WGetNET.WinGetPackageManager class offers methods to manage packages with winget.">WGetNET.WinGetPackageManager</a> class offers methods to manage packages with winget </td></tr>
-<tr id="row_0_6_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d6/db3/a00130.html" target="_self">WinGetPinnedPackage</a></td><td class="desc">Represents a winget pinned package </td></tr>
-<tr id="row_0_7_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="de/d76/a00134.html" target="_self">WinGetSource</a></td><td class="desc">Represents a winget source </td></tr>
-<tr id="row_0_8_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="da/d2a/a00086.html" target="_self">WinGetSourceManager</a></td><td class="desc">The <a class="el" href="da/d2a/a00086.html" title="The WGetNET.WinGetSourceManager class offers methods to manage the sources used by winget.">WGetNET.WinGetSourceManager</a> class offers methods to manage the sources used by winget </td></tr>
+<tr id="row_0_" class="even"><td class="entry"><span style="width:0px;display:inline-block;">&#160;</span><span id="arr_0_" class="arrow" onclick="toggleFolder('0_')">&#9660;</span><span class="icona"><span class="icon">N</span></span><a class="el" href="db/db6/a00074.html" target="_self">WGetNET</a></td><td class="desc"></td></tr>
+<tr id="row_0_0_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d3/d32/a00105.html" target="_self">WinGetActionFailedException</a></td><td class="desc">Exception that gets thrown if a winget action failed </td></tr>
+<tr id="row_0_1_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="da/ddb/a00145.html" target="_self">WinGetAdminOption</a></td><td class="desc">Represents a winget admin settings entry </td></tr>
+<tr id="row_0_2_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="da/d1e/a00149.html" target="_self">WinGetData</a></td><td class="desc">Represents WinGet related data </td></tr>
+<tr id="row_0_3_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="dd/d42/a00109.html" target="_self">WinGetFeatureNotSupportedException</a></td><td class="desc">Exception that gets thrown if a winget feature is not supportet in the installed winget version </td></tr>
+<tr id="row_0_4_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d4/d7d/a00093.html" target="_self">WinGetInfo</a></td><td class="desc">The <a class="el" href="d4/d7d/a00093.html" title="The WGetNET.WinGetInfo class offers informations about the installed winget version.">WGetNET.WinGetInfo</a> class offers informations about the installed winget version </td></tr>
+<tr id="row_0_5_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="da/d01/a00153.html" target="_self">WinGetInfoEntry</a></td><td class="desc">Represents a basic WinGet info entry </td></tr>
+<tr id="row_0_6_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d3/d00/a00113.html" target="_self">WinGetNotInstalledException</a></td><td class="desc">Exception that gets thrown if winget is not installed </td></tr>
+<tr id="row_0_7_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d1/db7/a00157.html" target="_self">WinGetPackage</a></td><td class="desc">Represents a winget package </td></tr>
+<tr id="row_0_8_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d1/d84/a00097.html" target="_self">WinGetPackageManager</a></td><td class="desc">The <a class="el" href="d1/d84/a00097.html" title="The WGetNET.WinGetPackageManager class offers methods to manage packages with winget.">WGetNET.WinGetPackageManager</a> class offers methods to manage packages with winget </td></tr>
+<tr id="row_0_9_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d6/d7d/a00161.html" target="_self">WinGetPinnedPackage</a></td><td class="desc">Represents a winget pinned package </td></tr>
+<tr id="row_0_10_" class="odd"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d0/d48/a00165.html" target="_self">WinGetSource</a></td><td class="desc">Represents a winget source </td></tr>
+<tr id="row_0_11_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d4/d3a/a00101.html" target="_self">WinGetSourceManager</a></td><td class="desc">The <a class="el" href="d4/d3a/a00101.html" title="The WGetNET.WinGetSourceManager class offers methods to manage the sources used by winget.">WGetNET.WinGetSourceManager</a> class offers methods to manage the sources used by winget </td></tr>
 </table>
 </div><!-- directory -->
 </div><!-- contents -->

docs/annotated_dup.js

@@ -1,14 +1,17 @@
 var annotated_dup =
 [
-    [ "WGetNET", "d3/d8b/a00059.html", [
-      [ "WinGetActionFailedException", "d9/dec/a00090.html", "d9/dec/a00090" ],
-      [ "WinGetFeatureNotSupportedException", "dc/d54/a00094.html", "dc/d54/a00094" ],
-      [ "WinGetInfo", "d9/da4/a00078.html", "d9/da4/a00078" ],
-      [ "WinGetNotInstalledException", "d1/d44/a00098.html", "d1/d44/a00098" ],
-      [ "WinGetPackage", "d7/d12/a00126.html", "d7/d12/a00126" ],
-      [ "WinGetPackageManager", "d4/d63/a00082.html", "d4/d63/a00082" ],
-      [ "WinGetPinnedPackage", "d6/db3/a00130.html", "d6/db3/a00130" ],
-      [ "WinGetSource", "de/d76/a00134.html", "de/d76/a00134" ],
-      [ "WinGetSourceManager", "da/d2a/a00086.html", "da/d2a/a00086" ]
+    [ "WGetNET", "db/db6/a00074.html", [
+      [ "WinGetActionFailedException", "d3/d32/a00105.html", "d3/d32/a00105" ],
+      [ "WinGetAdminOption", "da/ddb/a00145.html", "da/ddb/a00145" ],
+      [ "WinGetData", "da/d1e/a00149.html", "da/d1e/a00149" ],
+      [ "WinGetFeatureNotSupportedException", "dd/d42/a00109.html", "dd/d42/a00109" ],
+      [ "WinGetInfo", "d4/d7d/a00093.html", "d4/d7d/a00093" ],
+      [ "WinGetInfoEntry", "da/d01/a00153.html", "da/d01/a00153" ],
+      [ "WinGetNotInstalledException", "d3/d00/a00113.html", "d3/d00/a00113" ],
+      [ "WinGetPackage", "d1/db7/a00157.html", "d1/db7/a00157" ],
+      [ "WinGetPackageManager", "d1/d84/a00097.html", "d1/d84/a00097" ],
+      [ "WinGetPinnedPackage", "d6/d7d/a00161.html", "d6/d7d/a00161" ],
+      [ "WinGetSource", "d0/d48/a00165.html", "d0/d48/a00165" ],
+      [ "WinGetSourceManager", "d4/d3a/a00101.html", "d4/d3a/a00101" ]
     ] ]
 ];

docs/classes.html

@@ -25,7 +25,7 @@
  <tbody>
  <tr id="projectrow">
   <td id="projectalign">
-   <div id="projectname">WGet.NET<span id="projectnumber">&#160;3.1.0</span>
+   <div id="projectname">WGet.NET<span id="projectnumber">&#160;3.2.0</span>
    </div>
    <div id="projectbrief">A WinGet wrapper library for .Net.</div>
   </td>
@@ -97,7 +97,7 @@
 <div class="classindex">
 <dl class="classindex even">
 <dt class="alphachar"><a id="letter_W" name="letter_W">W</a></dt>
-<dd><a class="el" href="d9/dec/a00090.html">WinGetActionFailedException</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="dc/d54/a00094.html">WinGetFeatureNotSupportedException</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="d9/da4/a00078.html">WinGetInfo</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="d1/d44/a00098.html">WinGetNotInstalledException</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="d7/d12/a00126.html">WinGetPackage</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="d4/d63/a00082.html">WinGetPackageManager</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="d6/db3/a00130.html">WinGetPinnedPackage</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="de/d76/a00134.html">WinGetSource</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd><dd><a class="el" href="da/d2a/a00086.html">WinGetSourceManager</a> (<a class="el" href="d3/d8b/a00059.html">WGetNET</a>)</dd></dl>
+<dd><a class="el" href="d3/d32/a00105.html">WinGetActionFailedException</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="da/ddb/a00145.html">WinGetAdminOption</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="da/d1e/a00149.html">WinGetData</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="dd/d42/a00109.html">WinGetFeatureNotSupportedException</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="d4/d7d/a00093.html">WinGetInfo</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="da/d01/a00153.html">WinGetInfoEntry</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="d3/d00/a00113.html">WinGetNotInstalledException</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="d1/db7/a00157.html">WinGetPackage</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="d1/d84/a00097.html">WinGetPackageManager</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="d6/d7d/a00161.html">WinGetPinnedPackage</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="d0/d48/a00165.html">WinGetSource</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd><dd><a class="el" href="d4/d3a/a00101.html">WinGetSourceManager</a> (<a class="el" href="db/db6/a00074.html">WGetNET</a>)</dd></dl>
 </div>
 </div><!-- contents -->
 </div><!-- doc-content -->