Renamed WinGetAdminOption to WinGetAdminSetting; Changed the builder name and xml docs to fit the new name

Author: basicx-StrgV

…c/WGet.NET/Builder/AdminOptionBuilder.cs …/WGet.NET/Builder/AdminSettingBuilder.cssrc/WGet.NET/Builder/AdminOptionBuilder.cs renamed to src/WGet.NET/Builder/AdminSettingBuilder.cs src/WGet.NET/Builder/AdminOptionBuilder.cs renamed to src/WGet.NET/Builder/AdminSettingBuilder.cs

@@ -7,9 +7,9 @@
 namespace WGetNET.Builder
 {
     /// <summary>
-    /// Builder to create a new <see cref="WGetNET.WinGetAdminOption"/> instance.
+    /// Builder to create a new <see cref="WGetNET.WinGetAdminSetting"/> instance.
     /// </summary>
-    internal class AdminOptionBuilder : WinGetObjectBuilder<WinGetAdminOption?>
+    internal class AdminSettingBuilder : WinGetObjectBuilder<WinGetAdminSetting?>
     {
         private string _entryName = string.Empty;
         private string _rawContent = string.Empty;
@@ -19,9 +19,9 @@ internal class AdminOptionBuilder : WinGetObjectBuilder<WinGetAdminOption?>
         private bool _parsed = false;
 
         /// <summary>
-        /// Initializes a new instance of the <see cref="WGetNET.Builder.AdminOptionBuilder"/> class.
+        /// Initializes a new instance of the <see cref="WGetNET.Builder.AdminSettingBuilder"/> class.
         /// </summary>
-        public AdminOptionBuilder()
+        public AdminSettingBuilder()
         {
             // Provide empty constructor
         }
@@ -65,19 +65,19 @@ public void AddRawContent(string rawContent)
         }
 
         /// <summary>
-        /// Returns a <see cref="WGetNET.WinGetAdminOption"/> instance from data provided to the builder.
+        /// Returns a <see cref="WGetNET.WinGetAdminSetting"/> instance from data provided to the builder.
         /// </summary>
         /// <returns>
-        /// The created <see cref="WGetNET.WinGetAdminOption"/> instance, or <see langword="null"/> if the provided data failed to be parsed.
+        /// The created <see cref="WGetNET.WinGetAdminSetting"/> instance, or <see langword="null"/> if the provided data failed to be parsed.
         /// </returns>
-        public override WinGetAdminOption? GetInstance()
+        public override WinGetAdminSetting? GetInstance()
         {
             if (!_parsed)
             {
                 return null;
             }
 
-            return new WinGetAdminOption(_entryName, _rawContent, _hasShortenedContent, _isEnabled);
+            return new WinGetAdminSetting(_entryName, _rawContent, _hasShortenedContent, _isEnabled);
         }
 
         /// <inheritdoc/>
@@ -89,6 +89,18 @@ public override void Clear()
             _isEnabled = false;
         }
 
+        /// <summary>
+        /// Parses the raw content to a <see cref="System.Boolean"/> value.
+        /// </summary>
+        /// <param name="rawContent">
+        /// A <see cref="System.String"/> containing the raw content.
+        /// </param>
+        /// <param name="hasShortenedContent">
+        /// Indicates if the content is shortened or not.
+        /// </param>
+        /// <returns>
+        /// The paresed <see cref="System.Boolean"/> value or <see langword="null"/> if parsing failed.
+        /// </returns>
         private bool? ParseToBool(string rawContent, bool hasShortenedContent)
         {
             bool isEnabled = false;

src/WGet.NET/Builder/InfoSetBuilder.cs

@@ -18,7 +18,7 @@ internal class InfoSetBuilder : WinGetObjectBuilder<WinGetInfo>
         private Version? _version = null;
         private List<WinGetDirectory> _directories = new();
         private List<WinGetLink> _links = new();
-        private List<WinGetAdminOption> _adminSettings = new();
+        private List<WinGetAdminSetting> _adminSettings = new();
 
         /// <summary>
         /// Initializes a new instance of the <see cref="WGetNET.Builder.InfoSetBuilder"/> class.
@@ -103,23 +103,23 @@ public void AddLink(WinGetLink? link)
         }
 
         /// <summary>
-        /// Adds a <see cref="System.Collections.Generic.List{T}"/> of <see cref="WinGetAdminOption"/> objects.
+        /// Adds a <see cref="System.Collections.Generic.List{T}"/> of <see cref="WinGetAdminSetting"/> objects.
         /// </summary>
         /// <param name="adminOptions">
-        /// The <see cref="System.Collections.Generic.List{T}"/> of <see cref="WinGetAdminOption"/> objects.
+        /// The <see cref="System.Collections.Generic.List{T}"/> of <see cref="WinGetAdminSetting"/> objects.
         /// </param>
-        public void AddAdminOptions(List<WinGetAdminOption> adminOptions)
+        public void AddAdminOptions(List<WinGetAdminSetting> adminOptions)
         {
             _adminSettings.AddRange(adminOptions);
         }
 
         /// <summary>
-        /// Adds a <see cref="WinGetAdminOption"/> object.
+        /// Adds a <see cref="WinGetAdminSetting"/> object.
         /// </summary>
         /// <param name="adminOption">
-        /// The <see cref="WinGetAdminOption"/> object.
+        /// The <see cref="WinGetAdminSetting"/> object.
         /// </param>
-        public void AddAdminOption(WinGetAdminOption? adminOption)
+        public void AddAdminOption(WinGetAdminSetting? adminOption)
         {
             if (adminOption != null)
             {
@@ -150,7 +150,7 @@ public override void Clear()
             _version = null;
             _directories = new List<WinGetDirectory>();
             _links = new List<WinGetLink>();
-            _adminSettings = new List<WinGetAdminOption>();
+            _adminSettings = new List<WinGetAdminSetting>();
         }
     }
 }

src/WGet.NET/Components/Internal/ProcessOutputReader.cs

@@ -757,13 +757,13 @@ private List<WinGetLink> ReadLinks(string[] output)
         /// </remarks>
         /// <param name="output">The <see langword="array"/> containing the winget output lines.</param>
         /// <returns>
-        /// A <see cref="System.Collections.Generic.List{T}"/> of <see cref="WGetNET.WinGetAdminOption"/> objects.
+        /// A <see cref="System.Collections.Generic.List{T}"/> of <see cref="WGetNET.WinGetAdminSetting"/> objects.
         /// </returns>
-        private List<WinGetAdminOption> ReadAdminSettings(string[] output)
+        private List<WinGetAdminSetting> ReadAdminSettings(string[] output)
         {
-            List<WinGetAdminOption> adminSetting = new();
+            List<WinGetAdminSetting> adminSetting = new();
 
-            AdminOptionBuilder adminOptionBuilder = new();
+            AdminSettingBuilder adminOptionBuilder = new();
 
             for (int i = 0; i < output.Length; i++)
             {
@@ -781,7 +781,7 @@ private List<WinGetAdminOption> ReadAdminSettings(string[] output)
                     adminOptionBuilder.AddEntryName(settingsEntry[0].Trim());
                     adminOptionBuilder.AddRawContent(settingsEntry[1].Trim());
 
-                    WinGetAdminOption? adminOption = adminOptionBuilder.GetInstance();
+                    WinGetAdminSetting? adminOption = adminOptionBuilder.GetInstance();
                     if (adminOption != null)
                     {
                         adminSetting.Add(adminOption);

src/WGet.NET/Components/WinGet.cs

@@ -300,7 +300,7 @@ public bool EnableAdminSetting(string settingName)
         /// Enables the provided admin setting (Needs administrator rights).
         /// </summary>
         /// <param name="setting">
-        /// The <see cref="WGetNET.WinGetAdminOption"/> to enable.
+        /// The <see cref="WGetNET.WinGetAdminSetting"/> to enable.
         /// </param>
         /// <returns>
         /// <see langword="true"/> if the action was succesfull and <see langword="false"/> if it failed.
@@ -317,7 +317,7 @@ public bool EnableAdminSetting(string settingName)
         /// <exception cref="System.Security.SecurityException">
         /// The current user is missing administrator privileges for this call.
         /// </exception>
-        public bool EnableAdminSetting(WinGetAdminOption setting)
+        public bool EnableAdminSetting(WinGetAdminSetting setting)
         {
             ArgsHelper.ThrowIfObjectIsNull(setting, "setting");
 
@@ -361,7 +361,7 @@ public async Task<bool> EnableAdminSettingAsync(string settingName)
         /// Asynchronously enables the provided admin setting (Needs administrator rights).
         /// </summary>
         /// <param name="setting">
-        /// The <see cref="WGetNET.WinGetAdminOption"/> to enable.
+        /// The <see cref="WGetNET.WinGetAdminSetting"/> to enable.
         /// </param>
         /// <returns>
         /// A <see cref="System.Threading.Tasks.Task"/>, containing the result.
@@ -379,7 +379,7 @@ public async Task<bool> EnableAdminSettingAsync(string settingName)
         /// <exception cref="System.Security.SecurityException">
         /// The current user is missing administrator privileges for this call.
         /// </exception>
-        public async Task<bool> EnableAdminSettingAsynv(WinGetAdminOption setting)
+        public async Task<bool> EnableAdminSettingAsynv(WinGetAdminSetting setting)
         {
             ArgsHelper.ThrowIfObjectIsNull(setting, "setting");
 
@@ -422,7 +422,7 @@ public bool DisableAdminSetting(string settingName)
         /// Disables the provided admin setting (Needs administrator rights).
         /// </summary>
         /// <param name="setting">
-        /// The <see cref="WGetNET.WinGetAdminOption"/> to disable.
+        /// The <see cref="WGetNET.WinGetAdminSetting"/> to disable.
         /// </param>
         /// <returns>
         /// <see langword="true"/> if the action was succesfull and <see langword="false"/> if it failed.
@@ -439,7 +439,7 @@ public bool DisableAdminSetting(string settingName)
         /// <exception cref="System.Security.SecurityException">
         /// The current user is missing administrator privileges for this call.
         /// </exception>
-        public bool DisableAdminSetting(WinGetAdminOption setting)
+        public bool DisableAdminSetting(WinGetAdminSetting setting)
         {
             ArgsHelper.ThrowIfObjectIsNull(setting, "setting");
 
@@ -483,7 +483,7 @@ public async Task<bool> DisableAdminSettingAsync(string settingName)
         /// Asynchronously disables the provided admin setting (Needs administrator rights).
         /// </summary>
         /// <param name="setting">
-        /// The <see cref="WGetNET.WinGetAdminOption"/> to disable.
+        /// The <see cref="WGetNET.WinGetAdminSetting"/> to disable.
         /// </param>
         /// <returns>
         /// A <see cref="System.Threading.Tasks.Task"/>, containing the result.
@@ -501,7 +501,7 @@ public async Task<bool> DisableAdminSettingAsync(string settingName)
         /// <exception cref="System.Security.SecurityException">
         /// The current user is missing administrator privileges for this call.
         /// </exception>
-        public async Task<bool> DisableAdminSettingAsync(WinGetAdminOption setting)
+        public async Task<bool> DisableAdminSettingAsync(WinGetAdminSetting setting)
         {
             ArgsHelper.ThrowIfObjectIsNull(setting, "setting");
 

src/WGet.NET/Components/WinGetSourceManager.cs

@@ -1037,7 +1037,7 @@ public string SourcesToJson(IEnumerable<WinGetSource> sources)
             ArgsHelper.ThrowIfObjectIsNull(sources, "sources");
 
             // Create source models for json parsing
-            List<SourceModel> models = new List<SourceModel>();
+            List<SourceModel> models = new();
             foreach (WinGetSource source in sources)
             {
                 models.Add(SourceModel.FromWinGetSource(source));

src/WGet.NET/Data/WinGetAdminOption.cs src/WGet.NET/Data/WinGetAdminSetting.cssrc/WGet.NET/Data/WinGetAdminOption.cs renamed to src/WGet.NET/Data/WinGetAdminSetting.cs

@@ -9,7 +9,7 @@ namespace WGetNET
     /// <summary>
     /// Represents a winget admin settings entry.
     /// </summary>
-    public sealed class WinGetAdminOption : WinGetInfoEntry<WinGetAdminOption>
+    public sealed class WinGetAdminSetting : WinGetInfoEntry<WinGetAdminSetting>
     {
         /// <summary>
         /// Gets if the admin option is enabled.
@@ -25,19 +25,19 @@ public bool IsEnabled
         private readonly bool _isEnabled;
 
         /// <summary>
-        /// Initializes a new instance of the <see cref="WGetNET.WinGetAdminOption"/> class.
+        /// Initializes a new instance of the <see cref="WGetNET.WinGetAdminSetting"/> class.
         /// </summary>
         /// <param name="entryName">The name of the settings entry.</param>
         /// <param name="rawContent">The content of the settings entry.</param>
         /// <param name="hasShortenedContent">Sets if the content is shortened or not.</param>
         /// <param name="isEnabled">Idicator for the setting state.</param>
-        internal WinGetAdminOption(string entryName, string rawContent, bool hasShortenedContent, bool isEnabled) : base(entryName, rawContent, hasShortenedContent)
+        internal WinGetAdminSetting(string entryName, string rawContent, bool hasShortenedContent, bool isEnabled) : base(entryName, rawContent, hasShortenedContent)
         {
             _isEnabled = isEnabled;
         }
 
         /// <inheritdoc/>
-        public override bool Equals(WinGetAdminOption? other)
+        public override bool Equals(WinGetAdminSetting? other)
         {
             if (other == null)
             {
@@ -62,7 +62,7 @@ public override bool Equals(WinGetAdminOption? other)
         /// <inheritdoc/>
         public override object Clone()
         {
-            return new WinGetAdminOption(
+            return new WinGetAdminSetting(
                     _entryName,
                     _rawContent,
                     _hasShortenedContent,

src/WGet.NET/Data/WinGetInfo.cs

@@ -60,7 +60,7 @@ public ReadOnlyCollection<WinGetLink> Links
         /// <summary>
         /// Gets a collection of the winget admin settings.
         /// </summary>
-        public ReadOnlyCollection<WinGetAdminOption> AdminSettings
+        public ReadOnlyCollection<WinGetAdminSetting> AdminSettings
         {
             get
             {
@@ -93,15 +93,15 @@ internal static WinGetInfo Empty
         {
             get
             {
-                return new WinGetInfo("", new Version(0, 0), new List<WinGetDirectory>(), new List<WinGetLink>(), new List<WinGetAdminOption>());
+                return new WinGetInfo("", new Version(0, 0), new List<WinGetDirectory>(), new List<WinGetLink>(), new List<WinGetAdminSetting>());
             }
         }
 
         private readonly string _versionString;
         private readonly Version _version;
         private readonly ReadOnlyCollection<WinGetDirectory> _directories;
         private readonly ReadOnlyCollection<WinGetLink> _links;
-        private readonly ReadOnlyCollection<WinGetAdminOption> _adminSettings;
+        private readonly ReadOnlyCollection<WinGetAdminSetting> _adminSettings;
 
         /// <summary>
         /// Initializes a new instance of the <see cref="WGetNET.WinGetInfo"/> class.
@@ -117,13 +117,13 @@ internal static WinGetInfo Empty
         /// <param name="adminSettings">
         /// <see cref="System.Collections.Generic.List{T}"/> of info entries containing the WinGet admin setting states.
         /// </param>
-        internal WinGetInfo(string versionString, Version version, List<WinGetDirectory> directories, List<WinGetLink> links, List<WinGetAdminOption> adminSettings)
+        internal WinGetInfo(string versionString, Version version, List<WinGetDirectory> directories, List<WinGetLink> links, List<WinGetAdminSetting> adminSettings)
         {
             _versionString = versionString;
             _version = version;
             _directories = new ReadOnlyCollection<WinGetDirectory>(directories);
             _links = new ReadOnlyCollection<WinGetLink>(links);
-            _adminSettings = new ReadOnlyCollection<WinGetAdminOption>(adminSettings);
+            _adminSettings = new ReadOnlyCollection<WinGetAdminSetting>(adminSettings);
         }
     }
 }