Fix Reset-WinGetSource behavior (#4732)

Author: ryfu-msft

src/PowerShell/Help/Microsoft.WinGet.Client/Assert-WinGetPackageManager.md

@@ -23,7 +23,7 @@ Assert-WinGetPackageManager [-Version <String>] [<CommonParameters>]
 ### IntegrityLatestSet
 
 ```
-Assert-WinGetPackageManager [-Latest] [-IncludePreRelease] [<CommonParameters>]
+Assert-WinGetPackageManager [-Latest] [-IncludePrerelease] [<CommonParameters>]
 ```
 
 ## DESCRIPTION

src/PowerShell/Help/Microsoft.WinGet.Client/Reset-WinGetSource.md

@@ -10,18 +10,26 @@ title: Reset-WinGetSource
 # Reset-WinGetSource
 
 ## SYNOPSIS
-Resets default WinGet sources.
+Resets WinGet sources.
 
 ## SYNTAX
 
+### DefaultSet (Default)
+
 ```
 Reset-WinGetSource -Name <String> [<CommonParameters>]
 ```
 
+### OptionalSet
+
+```
+Reset-WinGetSource -All [<CommonParameters>]
+```
+
 ## DESCRIPTION
 
-Resets the current WinGet sources to the default source configurations. This command must be
-executed with administrator permissions.
+Resets a named WinGet source by removing the source configuration. You can reset all configured sources and add the default source configurations using the **All** switch parameter.
+This command must be executed with administrator permissions.
 
 ## EXAMPLES
 
@@ -33,15 +41,39 @@ Reset-WinGetSource -Name msstore
 
 This example resets the configured source named 'msstore' by removing it.
 
+### Example 2: Reset all sources
+
+```powershell
+Reset-WinGetSource -All
+```
+
+This example resets all configured sources and adds the default sources.
+
 ## PARAMETERS
 
+### -All
+
+Reset all sources and add the default sources.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (OptionalSet)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
 ### -Name
 
 The name of the source.
 
 ```yaml
 Type: System.String
-Parameter Sets: (All)
+Parameter Sets: (DefaultSet)
 Aliases:
 
 Required: True

src/PowerShell/Microsoft.WinGet.Client.Cmdlets/Cmdlets/AssertWinGetPackageManagerCmdlet.cs

@@ -1,4 +1,4 @@
-// -----------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
 // <copyright file="AssertWinGetPackageManagerCmdlet.cs" company="Microsoft Corporation">
 //     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
 // </copyright>
@@ -29,7 +29,7 @@ protected override void ProcessRecord()
             var command = new WinGetPackageManagerCommand(this);
             if (this.ParameterSetName == Constants.IntegrityLatestSet)
             {
-                command.AssertUsingLatest(this.IncludePreRelease.ToBool());
+                command.AssertUsingLatest(this.IncludePrerelease.ToBool());
             }
             else
             {

src/PowerShell/Microsoft.WinGet.Client.Cmdlets/Cmdlets/Common/WinGetPackageManagerCmdlet.cs

@@ -1,4 +1,4 @@
-// -----------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
 // <copyright file="WinGetPackageManagerCmdlet.cs" company="Microsoft Corporation">
 //     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
 // </copyright>
@@ -36,6 +36,6 @@ public abstract class WinGetPackageManagerCmdlet : PSCmdlet
         [Parameter(
             ParameterSetName = Constants.IntegrityLatestSet,
             ValueFromPipelineByPropertyName = true)]
-        public SwitchParameter IncludePreRelease { get; set; }
+        public SwitchParameter IncludePrerelease { get; set; }
     }
 }

src/PowerShell/Microsoft.WinGet.Client.Cmdlets/Cmdlets/RemoveSourceCmdlet.cs

@@ -1,4 +1,4 @@
-// -----------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
 // <copyright file="RemoveSourceCmdlet.cs" company="Microsoft Corporation">
 //     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
 // </copyright>
@@ -20,6 +20,7 @@ public sealed class RemoveSourceCmdlet : PSCmdlet
         /// Gets or sets the name of the source to remove.
         /// </summary>
         [Parameter(
+            Position = 0,
             Mandatory = true,
             ValueFromPipeline = true,
             ValueFromPipelineByPropertyName = true)]

src/PowerShell/Microsoft.WinGet.Client.Cmdlets/Cmdlets/RepairWinGetPackageManagerCmdlet.cs

@@ -44,7 +44,7 @@ protected override void ProcessRecord()
             this.command = new WinGetPackageManagerCommand(this);
             if (this.ParameterSetName == Constants.IntegrityLatestSet)
             {
-                this.command.RepairUsingLatest(this.IncludePreRelease.ToBool(), this.AllUsers.ToBool(), this.Force.ToBool());
+                this.command.RepairUsingLatest(this.IncludePrerelease.ToBool(), this.AllUsers.ToBool(), this.Force.ToBool());
             }
             else
             {

src/PowerShell/Microsoft.WinGet.Client.Cmdlets/Cmdlets/ResetSourceCmdlet.cs

@@ -1,4 +1,4 @@
-// -----------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
 // <copyright file="ResetSourceCmdlet.cs" company="Microsoft Corporation">
 //     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
 // </copyright>
@@ -13,25 +13,41 @@ namespace Microsoft.WinGet.Client.Cmdlets.Cmdlets
     /// <summary>
     /// Resets a source. Requires admin.
     /// </summary>
-    [Cmdlet(VerbsCommon.Reset, Constants.WinGetNouns.Source)]
+    [Cmdlet(VerbsCommon.Reset, Constants.WinGetNouns.Source, DefaultParameterSetName = Constants.DefaultSet)]
     public sealed class ResetSourceCmdlet : PSCmdlet
     {
         /// <summary>
         /// Gets or sets the name of the source to reset.
         /// </summary>
         [Parameter(
+            Position = 0,
             Mandatory = true,
+            ParameterSetName = Constants.DefaultSet,
             ValueFromPipeline = true,
             ValueFromPipelineByPropertyName = true)]
         public string Name { get; set; }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether to reset all sources.
+        /// </summary>
+        [Parameter(ParameterSetName = Constants.OptionalSet, ValueFromPipelineByPropertyName = true)]
+        public SwitchParameter All { get; set; }
+
         /// <summary>
         /// Resets source.
         /// </summary>
         protected override void ProcessRecord()
         {
             var command = new CliCommand(this);
-            command.ResetSource(this.Name);
+
+            if (!string.IsNullOrEmpty(this.Name))
+            {
+                command.ResetSourceByName(this.Name);
+            }
+            else if (this.All)
+            {
+                command.ResetAllSources();
+            }
         }
     }
 }

src/PowerShell/Microsoft.WinGet.Client.Cmdlets/Common/Constants.cs

@@ -1,4 +1,4 @@
-// -----------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
 // <copyright file="Constants.cs" company="Microsoft Corporation">
 //     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
 // </copyright>
@@ -30,7 +30,17 @@ internal static class Constants
         /// This parameter set indicates that a package was not provided via a parameter or the pipeline and it
         /// needs to be found by searching a package source.
         /// </summary>
-        public const string FoundSet = "FoundSet";
+        public const string FoundSet = "FoundSet";
+
+        /// <summary>
+        /// This parameter set indicates the default parameters associated with a cmdlet.
+        /// </summary>
+        public const string DefaultSet = "DefaultSet";
+
+        /// <summary>
+        ///  This parameter set indicates the optional parameters associated with a cmdlet.
+        /// </summary>
+        public const string OptionalSet = "OptionalSet";
 
         /// <summary>
         /// Parameter set for an specific version parameter.

src/PowerShell/Microsoft.WinGet.Client.Cmdlets/Microsoft.WinGet.Client.Cmdlets.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <!-- If these target frameworks are updated, make sure to also update the .psd1 and .nuspec files.-->

src/PowerShell/Microsoft.WinGet.Client.Engine/Commands/CliCommand.cs

@@ -1,4 +1,4 @@
-// -----------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
 // <copyright file="CliCommand.cs" company="Microsoft Corporation">
 //     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
 // </copyright>
@@ -94,15 +94,24 @@ public void RemoveSource(string name)
         }
 
         /// <summary>
-        /// Resets source.
+        /// Resets a source.
         /// </summary>
         /// <param name="name">Name of source.</param>
-        public void ResetSource(string name)
+        public void ResetSourceByName(string name)
         {
             Utilities.VerifyAdmin();
             _ = this.Run("source", $"reset --name {name} --force");
         }
 
+        /// <summary>
+        /// Resets all sources and adds the defaults.
+        /// </summary>
+        public void ResetAllSources()
+        {
+            Utilities.VerifyAdmin();
+            _ = this.Run("source", $"reset --force");
+        }
+
         private WinGetCLICommandResult Run(string command, string parameters, int timeOut = 60000)
         {
             var wingetCliWrapper = new WingetCLIWrapper();

src/PowerShell/Microsoft.WinGet.Client.Engine/Helpers/GitHubClient.cs

@@ -1,4 +1,4 @@
-// -----------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
 // <copyright file="GitHubClient.cs" company="Microsoft Corporation">
 //     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
 // </copyright>
@@ -43,24 +43,24 @@ public async Task<Release> GetReleaseAsync(string releaseTag)
         /// <summary>
         /// Gets the latest released and waits.
         /// </summary>
-        /// <param name="includePreRelease">Include prerelease.</param>
+        /// <param name="includePrerelease">Include prerelease.</param>
         /// <returns>Latest version.</returns>
-        public async Task<string> GetLatestReleaseTagNameAsync(bool includePreRelease)
+        public async Task<string> GetLatestReleaseTagNameAsync(bool includePrerelease)
         {
-            return (await this.GetLatestReleaseAsync(includePreRelease)).TagName;
+            return (await this.GetLatestReleaseAsync(includePrerelease)).TagName;
         }
 
         /// <summary>
         /// Gets the latest released version.
         /// </summary>
-        /// <param name="includePreRelease">Include prerelease.</param>
+        /// <param name="includePrerelease">Include prerelease.</param>
         /// <returns>Latest version.</returns>
-        public async Task<Release> GetLatestReleaseAsync(bool includePreRelease)
+        public async Task<Release> GetLatestReleaseAsync(bool includePrerelease)
         {
             Release release;
 
             // GetLatest doesn't respect prerelease or gives an option to get it.
-            if (includePreRelease)
+            if (includePrerelease)
             {
                 // GetAll orders by newest and includes pre releases.
                 release = (await this.gitHubClient.Repository.Release.GetAll(this.owner, this.repo))[0];

src/PowerShell/Microsoft.WinGet.DSC/Microsoft.WinGet.DSC.psm1

@@ -366,7 +366,7 @@ class WinGetPackageManager
             } elseif ($this.UseLatestPreRelease)
             {
                 $hashArgs.Add("Latest", $true)
-                $hashArgs.Add("IncludePreRelease", $true)
+                $hashArgs.Add("IncludePrerelease", $true)
             } elseif (-not [string]::IsNullOrWhiteSpace($this.Version))
             {
                 $hashArgs.Add("Version", $this.Version)
@@ -398,7 +398,7 @@ class WinGetPackageManager
             } elseif ($this.UseLatestPreRelease)
             {
                 $hashArgs.Add("Latest", $true)
-                $hashArgs.Add("IncludePreRelease", $true)
+                $hashArgs.Add("IncludePrerelease", $true)
             } elseif (-not [string]::IsNullOrWhiteSpace($this.Version))
             {
                 $hashArgs.Add("Version", $this.Version)

src/PowerShell/tests/Microsoft.WinGet.Client.Tests.ps1

@@ -136,6 +136,21 @@ Describe 'Get-WinGetVersion' {
     }
 }
 
+Describe 'Reset-WinGetSource' {
+    BeforeAll {
+        AddTestSource
+    }
+
+    # Requires admin
+    It 'Resets all sources' {
+        Reset-WinGetSource -All
+    }
+
+    It 'Test source should be removed' {
+        { Get-WinGetSource -Name 'TestSource' } | Should -Throw
+    }
+}
+
 Describe 'Get|Add|Reset-WinGetSource' {
 
     BeforeAll {