Added asynchronous execution to the WinGetInfo and FileHandler class

Author: basicx-StrgV

src/WGet.NET/Components/WinGetInfo.cs

@@ -4,6 +4,7 @@
 //--------------------------------------------------//
 using System;
 using System.ComponentModel;
+using System.Threading.Tasks;
 using WGetNET.HelperClasses;
 
 namespace WGetNET
@@ -90,6 +91,38 @@ public string ExportSettings()
             }
         }
 
+        /// <summary>
+        /// Asynchronous exports the WinGet settings to a json string.
+        /// </summary>
+        /// <returns>
+        /// A <see cref="System.String"/> containing the settings json.
+        /// </returns>
+        /// <exception cref="WGetNET.WinGetNotInstalledException">
+        /// WinGet is not installed or not found on the system.
+        /// </exception>
+        /// <exception cref="WGetNET.WinGetActionFailedException">
+        /// The current action failed for an unexpected reason.
+        /// Please see inner exception.
+        /// </exception>
+        public async Task<string> ExportSettingsAsync()
+        {
+            try
+            {
+                ProcessResult result =
+                    await _processManager.ExecuteWingetProcessAsync(_exportSettingsCmd);
+
+                return ProcessOutputReader.ExportOutputToString(result);
+            }
+            catch (Win32Exception)
+            {
+                throw new WinGetNotInstalledException();
+            }
+            catch (Exception e)
+            {
+                throw new WinGetActionFailedException("Exporting sources failed.", e);
+            }
+        }
+
         /// <summary>
         /// Exports the WinGet settings to a json and writes them to the given file.
         /// </summary>
@@ -130,6 +163,46 @@ public bool ExportSettingsToFile(string file)
             }
         }
 
+        /// <summary>
+        /// Asynchronous exports the WinGet settings to a json and writes them to the given file.
+        /// </summary>
+        /// <param name="file">
+        /// The file for the export.
+        /// </param>
+        /// <returns>
+        /// <see langword="true"/> if the action was succesfull, and <see langword="false"/> if it failed.
+        /// </returns>
+        /// <exception cref="WGetNET.WinGetNotInstalledException">
+        /// WinGet is not installed or not found on the system.
+        /// </exception>
+        /// <exception cref="WGetNET.WinGetActionFailedException">
+        /// The current action failed for an unexpected reason.
+        /// Please see inner exception.
+        /// </exception>
+        public async Task<bool> ExportSettingsToFileAsync(string file)
+        {
+            if (string.IsNullOrWhiteSpace(file))
+            {
+                return false;
+            }
+
+            try
+            {
+                ProcessResult result =
+                    await _processManager.ExecuteWingetProcessAsync(_exportSettingsCmd);
+
+                return await FileHandler.ExportOutputToFileAsync(result, file);
+            }
+            catch (Win32Exception)
+            {
+                throw new WinGetNotInstalledException();
+            }
+            catch (Exception e)
+            {
+                throw new WinGetActionFailedException("Exporting sources failed.", e);
+            }
+        }
+
         private string CheckWinGetVersion()
         {
             try

src/WGet.NET/HelperClasses/FileHandler.cs

@@ -3,6 +3,7 @@
 // https://github.com/basicx-StrgV/                 //
 //--------------------------------------------------//
 using System.IO;
+using System.Threading.Tasks;
 
 namespace WGetNET.HelperClasses
 {
@@ -26,9 +27,36 @@ public static bool ExportOutputToFile(ProcessResult result, string file)
             {
                 string outputString = ProcessOutputReader.ExportOutputToString(result);
 
-                File.WriteAllText(
-                    file,
-                    outputString);
+                File.WriteAllText(file, outputString);
+
+                return true;
+            }
+            else
+            {
+                return false;
+            }
+        }
+
+        /// <summary>
+        /// Asynchronous writes the export result to a file.
+        /// </summary>
+        /// <param name="result">
+        /// The <see cref="WGetNET.ProcessResult"/> object containing the export data.
+        /// </param>
+        /// <param name="file">
+        /// A <see cref="System.String"/> containing the file path and name.
+        /// </param>
+        /// <returns>
+        /// <see langword="true"/> if the action was successfull and <see langword="false"/> if it failed.
+        /// </returns>
+        public static async Task<bool> ExportOutputToFileAsync(ProcessResult result, string file)
+        {
+            if (result.Success)
+            {
+                string outputString = ProcessOutputReader.ExportOutputToString(result);
+
+                await File.WriteAllTextAsync(file, outputString);
+
                 return true;
             }
             else

src/WGet.NET/XmlDocumentation/WGet.NET.xml

@@ -1,4 +1,5 @@
 using System;
+using System.Threading.Tasks;
 using System.Collections.Generic;
 using WGetNET;
 
@@ -54,7 +55,9 @@ private void Run()
                 string hash = connector.Hash("C:\\Test\\HashTest.txt");
                 Console.WriteLine(hash);
 
-                string settings = connector.ExportSettings();
+                Task<string> settingsTask = connector.ExportSettingsAsync();
+                settingsTask.Wait();
+                string settings = settingsTask.Result;
                 bool settingExportStatus = connector.ExportSettingsToFile("C:\\Test\\Settings.json");
             }
             catch (Exception e)