Implement uninstall tool command.

This commit implements the `uninstall tool` command.

The `uninstall tool` command is responsible for uninstalling global tools that
are installed with the `install tool` command.

This commit heavily refactors the ToolPackage and ShellShim namespaces to
better support the operations required for the uninstall command.

Several string resources have been updated to be more informative or to correct
oddly structured sentences.

This commit also fixes `--version` on the install command not supporting ranges
and wildcards.

Fixes #8549.

Issue #8485 is partially fixed by this commit (`--prerelease` is not yet
implemented).

Author: Peter Huene

src/Microsoft.DotNet.Cli.Utils/Constants.cs

@@ -21,5 +21,6 @@ public static class Constants
 
         public static readonly string ProjectArgumentName = "<PROJECT>";
         public static readonly string SolutionArgumentName = "<SLN_FILE>";
+        public static readonly string ToolPackageArgumentName = "<PACKAGE_ID>";
     }
 }

src/Microsoft.DotNet.InternalAbstractions/DirectoryWrapper.cs

@@ -19,9 +19,14 @@ public ITemporaryDirectory CreateTemporaryDirectory()
             return new TemporaryDirectory();
         }
 
-        public IEnumerable<string> GetFiles(string path, string searchPattern)
+        public IEnumerable<string> EnumerateFileSystemEntries(string path)
         {
-            return Directory.GetFiles(path, searchPattern);
+            return Directory.EnumerateFileSystemEntries(path);
+        }
+
+        public IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern)
+        {
+            return Directory.EnumerateFileSystemEntries(path, searchPattern);
         }
 
         public string GetDirectoryFullName(string path)
@@ -52,5 +57,10 @@ public void Delete(string path, bool recursive)
         {
             Directory.Delete(path, recursive);
         }
+
+        public void Move(string source, string destination)
+        {
+            Directory.Move(source, destination);
+        }
     }
 }

src/Microsoft.DotNet.InternalAbstractions/FileWrapper.cs

@@ -46,6 +46,11 @@ public void WriteAllText(string path, string content)
             File.WriteAllText(path, content);
         }
 
+        public void Move(string source, string destination)
+        {
+            File.Move(source, destination);
+        }
+
         public void Delete(string path)
         {
             File.Delete(path);

src/Microsoft.DotNet.InternalAbstractions/IDirectory.cs

@@ -11,12 +11,16 @@ internal interface IDirectory
 
         ITemporaryDirectory CreateTemporaryDirectory();
 
-        IEnumerable<string> GetFiles(string path, string searchPattern);
+        IEnumerable<string> EnumerateFileSystemEntries(string path);
+
+        IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);
 
         string GetDirectoryFullName(string path);
 
         void CreateDirectory(string path);
 
         void Delete(string path, bool recursive);
+
+        void Move(string source, string destination);
     }
 }

src/Microsoft.DotNet.InternalAbstractions/IFile.cs

@@ -25,6 +25,8 @@ Stream OpenFile(
 
         void WriteAllText(string path, string content);
 
+        void Move(string source, string destination);
+
         void Delete(string path);
     }
 }

src/dotnet/BuiltInCommandsCatalog.cs

@@ -18,6 +18,7 @@
 using Microsoft.DotNet.Tools.Sln;
 using Microsoft.DotNet.Tools.Store;
 using Microsoft.DotNet.Tools.Test;
+using Microsoft.DotNet.Tools.Uninstall;
 using Microsoft.DotNet.Tools.VSTest;
 using System.Collections.Generic;
 using Microsoft.DotNet.Tools.Install;
@@ -149,6 +150,10 @@ public static class BuiltInCommandsCatalog
             {
                 Command = InstallCommand.Run
             },
+            ["uninstall"] = new BuiltInCommandMetadata
+            {
+                Command = UninstallCommand.Run
+            },
             ["internal-reportinstallsuccess"] = new BuiltInCommandMetadata
             {
                 Command = InternalReportinstallsuccess.Run

src/dotnet/CommonLocalizableStrings.resx

@@ -520,9 +520,6 @@
   <data name="NoRestoreDescription" xml:space="preserve">
     <value>Does not do an implicit restore when executing the command.</value>
   </data>
-  <data name="NuGetConfigurationFileDoesNotExist" xml:space="preserve">
-    <value>NuGet configuration file {0} does not exist.</value>
-  </data>
   <data name="ToolSettingsInvalidXml" xml:space="preserve">
     <value>Invalid XML: {0}</value>
   </data>
@@ -541,46 +538,77 @@
   <data name="ToolSettingsUnsupportedRunner" xml:space="preserve">
     <value>Command '{0}' uses unsupported runner '{1}'."</value>
   </data>
-  <data name="EnvironmentPathLinuxManualInstruction" xml:space="preserve">
-    <value>Cannot find the tools executable path. Please ensure {0} is added to your PATH.
-If you are using bash. You can do this by running the following command:
+  <data name="ShellShimConflict" xml:space="preserve">
+    <value>Command '{0}' conflicts with an existing command from another tool.</value>
+  </data>
+  <data name="CannotCreateShimForEmptyExecutablePath" xml:space="preserve">
+    <value>Cannot create shell shim for an empty executable path.</value>
+  </data>
+  <data name="CannotCreateShimForEmptyCommand" xml:space="preserve">
+    <value>Cannot create shell shim for an empty command.</value>
+  </data>
+  <data name="FailedToRetrieveToolConfiguration" xml:space="preserve">
+    <value>Failed to retrieve tool configuration: {0}</value>
+  </data>
+  <data name="EnvironmentPathLinuxManualInstructions" xml:space="preserve">
+    <value>Tools directory '{0}' is not currently on the PATH environment variable.
+If you are using bash, you can add it to your profile by running the following command:
 
-cat &lt;&lt; EOF &gt;&gt; ~/.bash_profile
+cat &lt;&lt; \EOF &gt;&gt; ~/.bash_profile
 # Add .NET Core SDK tools
-export PATH="$PATH:{1}"
-EOF</value>
+export PATH="$PATH:{0}"
+EOF
+
+You can add it to the current session by running the following command:
+
+export PATH="$PATH:{0}"
+</value>
   </data>
   <data name="EnvironmentPathLinuxNeedLogout" xml:space="preserve">
     <value>Since you just installed the .NET Core SDK, you will need to logout or restart your session before running the tool you installed.</value>
   </data>
-  <data name="EnvironmentPathOSXManualInstruction" xml:space="preserve">
-    <value>Cannot find the tools executable path. Please ensure {0} is added to your PATH.
-If you are using bash, You can do this by running the following command:
+  <data name="EnvironmentPathOSXManualInstructions" xml:space="preserve">
+    <value>Tools directory '{0}' is not currently on the PATH environment variable.
+If you are using bash, you can add it to your profile by running the following command:
 
-cat &lt;&lt; EOF &gt;&gt; ~/.bash_profile
+cat &lt;&lt; \EOF &gt;&gt; ~/.bash_profile
 # Add .NET Core SDK tools
-export PATH="$PATH:{1}"
-EOF</value>
+export PATH="$PATH:{0}"
+EOF
+
+You can add it to the current session by running the following command:
+
+export PATH="$PATH:{0}"
+</value>
   </data>
   <data name="EnvironmentPathOSXNeedReopen" xml:space="preserve">
     <value>Since you just installed the .NET Core SDK, you will need to reopen terminal before running the tool you installed.</value>
   </data>
-  <data name="EnvironmentPathWindowsManualInstruction" xml:space="preserve">
-    <value>Cannot find the tools executable path. Please ensure {0} is added to your PATH.
-You can do this by running the following command:
+  <data name="EnvironmentPathWindowsManualInstructions" xml:space="preserve">
+    <value>Tools directory '{0}' is not currently on the PATH environment variable.
+
+You can add the directory to the PATH by running the following command:
 
-setx PATH "%PATH%;{1}"</value>
+setx PATH "%PATH%;{0}"
+</value>
   </data>
   <data name="EnvironmentPathWindowsNeedReopen" xml:space="preserve">
     <value>Since you just installed the .NET Core SDK, you will need to reopen the Command Prompt window before running the tool you installed.</value>
   </data>
-  <data name="FailInstallToolPermission" xml:space="preserve">
-    <value>Failed to change permission:
-Error: {0}
-Output: {1}</value>
+  <data name="FailedToCreateShellShim" xml:space="preserve">
+    <value>Failed to create tool shim for command '{0}': {1}</value>
+  </data>
+  <data name="FailedToRemoveShellShim" xml:space="preserve">
+    <value>Failed to remove tool shim for command '{0}': {1}</value>
+  </data>
+  <data name="FailedSettingShimPermissions" xml:space="preserve">
+    <value>Failed to set user executable permissions for shell shim: {0}</value>
+  </data>
+  <data name="FailedToInstallToolPackage" xml:space="preserve">
+    <value>Failed to install tool package '{0}': {1}</value>
   </data>
-  <data name="FailInstallToolSameName" xml:space="preserve">
-    <value>Failed to install tool {0}. A command with the same name already exists.</value>
+  <data name="FailedToUninstallToolPackage" xml:space="preserve">
+    <value>Failed to uninstall tool package '{0}': {1}</value>
   </data>
   <data name="ToolPackageMissingEntryPointFile" xml:space="preserve">
     <value>Package '{0}' is missing entry point file {1}.</value>
@@ -589,6 +617,6 @@ Output: {1}</value>
     <value>Package '{0}' is missing tool settings file DotnetToolSettings.xml.</value>
   </data>
   <data name="ToolPackageConflictPackageId" xml:space="preserve">
-    <value>Tool '{0}' is already installed.</value>
+    <value>Tool '{0}' (version '{1}') is already installed.</value>
   </data>
 </root>

src/dotnet/Parser.cs

@@ -56,6 +56,7 @@ private static void ConfigureCommandLineLocalizedStrings()
                                     CompleteCommandParser.Complete(),
                                     InternalReportinstallsuccessCommandParser.InternalReportinstallsuccess(),
                                     InstallCommandParser.Install(),
+                                    UninstallCommandParser.Uninstall(),
                                     CommonOptions.HelpOption(),
                                     Create.Option("--info", ""),
                                     Create.Option("-d", ""),

src/dotnet/ShellShim/CreateShimTransaction.cs

@@ -9,7 +9,7 @@
 
 namespace Microsoft.DotNet.ShellShim
 {
-    public class DoNothingEnvironmentPath : IEnvironmentPath
+    internal class DoNothingEnvironmentPath : IEnvironmentPath
     {
         public void AddPackageExecutablePathToUserPath()
         {