Add TemplateService for Plaster integration

This change introduces a new TemplateService which uses the new Plaster
module to provide the following features:

1. Listing available Plaster templates on the user's machine, both
built-in and contained within other PowerShell modules

2. Creating new projects from Plaster templates

This functionality is exposed up through the language service by the
powerShell/getProjectTemplates and powerShell/newProjectFromTemplate
request types.

Author: daviwil

src/PowerShellEditorServices.Protocol/LanguageServer/ProjectTemplate.cs

@@ -0,0 +1,42 @@
+//
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+//
+
+using Microsoft.PowerShell.EditorServices.Protocol.MessageProtocol;
+using Microsoft.PowerShell.EditorServices.Templates;
+
+namespace Microsoft.PowerShell.EditorServices.Protocol.LanguageServer
+{
+    public class NewProjectFromTemplateRequest
+    {
+        public static readonly
+            RequestType<NewProjectFromTemplateRequest, NewProjectFromTemplateResponse> Type =
+            RequestType<NewProjectFromTemplateRequest, NewProjectFromTemplateResponse>.Create("powerShell/newProjectFromTemplate");
+
+        public string DestinationPath { get; set; }
+
+        public string TemplatePath { get; set; }
+    }
+
+    public class NewProjectFromTemplateResponse
+    {
+        public bool CreationSuccessful { get; set; }
+    }
+
+    public class GetProjectTemplatesRequest
+    {
+        public static readonly
+            RequestType<GetProjectTemplatesRequest, GetProjectTemplatesResponse> Type =
+            RequestType<GetProjectTemplatesRequest, GetProjectTemplatesResponse>.Create("powerShell/getProjectTemplates");
+
+        public bool IncludeInstalledModules { get; set; }
+    }
+
+    public class GetProjectTemplatesResponse
+    {
+        public bool NeedsModuleInstall { get; set; }
+
+        public TemplateDetails[] Templates { get; set; }
+    }
+}

src/PowerShellEditorServices.Protocol/PowerShellEditorServices.Protocol.csproj

@@ -62,6 +62,7 @@
     <Compile Include="LanguageServer\InstallModuleRequest.cs" />
     <Compile Include="LanguageServer\PowerShellVersionRequest.cs" />
     <Compile Include="LanguageServer\SetPSSARulesRequest.cs" />
+    <Compile Include="LanguageServer\ProjectTemplate.cs" />
     <Compile Include="MessageProtocol\Channel\NamedPipeClientChannel.cs" />
     <Compile Include="MessageProtocol\Channel\NamedPipeServerChannel.cs" />
     <Compile Include="MessageProtocol\Channel\TcpSocketClientChannel.cs" />

src/PowerShellEditorServices.Protocol/Server/LanguageServer.cs

@@ -8,6 +8,7 @@
 using Microsoft.PowerShell.EditorServices.Protocol.MessageProtocol;
 using Microsoft.PowerShell.EditorServices.Protocol.MessageProtocol.Channel;
 using Microsoft.PowerShell.EditorServices.Session;
+using Microsoft.PowerShell.EditorServices.Templates;
 using Microsoft.PowerShell.EditorServices.Utility;
 using Newtonsoft.Json.Linq;
 using System;
@@ -107,6 +108,9 @@ protected override void Initialize()
 
             this.SetRequestHandler(PowerShellVersionRequest.Type, this.HandlePowerShellVersionRequest);
 
+            this.SetRequestHandler(NewProjectFromTemplateRequest.Type, this.HandleNewProjectFromTemplateRequest);
+            this.SetRequestHandler(GetProjectTemplatesRequest.Type, this.HandleGetProjectTemplatesRequest);
+
             this.SetRequestHandler(DebugAdapterMessages.EvaluateRequest.Type, this.HandleEvaluateRequest);
 
             this.SetRequestHandler(GetPSSARulesRequest.Type, this.HandleGetPSSARulesRequest);
@@ -280,6 +284,55 @@ private Task HandleInvokeExtensionCommandRequest(
             return Task.FromResult(true);
         }
 
+        private Task HandleNewProjectFromTemplateRequest(
+            NewProjectFromTemplateRequest newProjectArgs,
+            RequestContext<NewProjectFromTemplateResponse> requestContext)
+        {
+            // Don't await the Task here so that we don't block the session
+            this.editorSession.TemplateService
+                .CreateFromTemplate(newProjectArgs.TemplatePath, newProjectArgs.DestinationPath)
+                .ContinueWith(
+                    async task =>
+                    {
+                        await requestContext.SendResult(
+                            new NewProjectFromTemplateResponse
+                            {
+                                CreationSuccessful = task.Result
+                            });
+                    });
+
+            return Task.FromResult(true);
+        }
+
+        private async Task HandleGetProjectTemplatesRequest(
+            GetProjectTemplatesRequest requestArgs,
+            RequestContext<GetProjectTemplatesResponse> requestContext)
+        {
+            bool plasterInstalled = await this.editorSession.TemplateService.ImportPlasterIfInstalled();
+
+            if (plasterInstalled)
+            {
+                var availableTemplates =
+                    await this.editorSession.TemplateService.GetAvailableTemplates(
+                        requestArgs.IncludeInstalledModules);
+
+                await requestContext.SendResult(
+                    new GetProjectTemplatesResponse
+                    {
+                        Templates = availableTemplates
+                    });
+            }
+            else
+            {
+                await requestContext.SendResult(
+                    new GetProjectTemplatesResponse
+                    {
+                        NeedsModuleInstall = true,
+                        Templates = new TemplateDetails[0]
+                    });
+            }
+        }
+
         private async Task HandleExpandAliasRequest(
             string content,
             RequestContext<string> requestContext)

src/PowerShellEditorServices/Nano.PowerShellEditorServices.csproj

@@ -71,6 +71,8 @@
     <Compile Include="Extensions\ExtensionService.cs" />
     <Compile Include="Extensions\FileContext.cs" />
     <Compile Include="Extensions\IEditorOperations.cs" />
+    <Compile Include="Templates\TemplateService.cs" />
+    <Compile Include="Templates\TemplateDetails.cs" />
     <Compile Include="Language\AstOperations.cs" />
     <Compile Include="Language\CommandHelpers.cs" />
     <Compile Include="Language\CompletionResults.cs" />
@@ -143,6 +145,7 @@
     <Compile Include="..\PowerShellEditorServices.Protocol\DebugAdapter\ContinueRequest.cs" />
     <Compile Include="..\PowerShellEditorServices.Protocol\DebugAdapter\SetFunctionBreakpointsRequest.cs" />
     <Compile Include="..\PowerShellEditorServices.Protocol\LanguageServer\EditorCommands.cs" />
+    <Compile Include="..\PowerShellEditorServices.Protocol\LanguageServer\ProjectTemplate.cs" />
     <Compile Include="..\PowerShellEditorServices.Protocol\LanguageServer\FindModuleRequest.cs" />
     <Compile Include="..\PowerShellEditorServices.Protocol\LanguageServer\InstallModuleRequest.cs" />
     <Compile Include="..\PowerShellEditorServices.Protocol\LanguageServer\PowerShellVersionRequest.cs" />

src/PowerShellEditorServices/PowerShellEditorServices.csproj

@@ -126,6 +126,8 @@
     <Compile Include="Session\SessionPSHostRawUserInterface.cs" />
     <Compile Include="Session\SessionPSHostUserInterface.cs" />
     <Compile Include="Session\SessionStateChangedEventArgs.cs" />
+    <Compile Include="Templates\TemplateDetails.cs" />
+    <Compile Include="Templates\TemplateService.cs" />
     <Compile Include="Utility\AsyncContextThread.cs" />
     <Compile Include="Utility\AsyncDebouncer.cs" />
     <Compile Include="Utility\AsyncLock.cs" />

src/PowerShellEditorServices/Session/EditorSession.cs

@@ -6,6 +6,7 @@
 using Microsoft.PowerShell.EditorServices.Console;
 using Microsoft.PowerShell.EditorServices.Extensions;
 using Microsoft.PowerShell.EditorServices.Session;
+using Microsoft.PowerShell.EditorServices.Templates;
 using Microsoft.PowerShell.EditorServices.Utility;
 using System.IO;
 
@@ -54,6 +55,11 @@ public class EditorSession
         /// </summary>
         public ExtensionService ExtensionService { get; private set; }
 
+        /// <summary>
+        /// Gets the TemplateService instance for this session.
+        /// </summary>
+        public TemplateService TemplateService { get; private set; }
+
         #endregion
 
         #region Public Methods
@@ -76,6 +82,7 @@ public void StartSession(HostDetails hostDetails, ProfilePaths profilePaths)
             this.DebugService = new DebugService(this.PowerShellContext);
             this.ConsoleService = new ConsoleService(this.PowerShellContext);
             this.ExtensionService = new ExtensionService(this.PowerShellContext);
+            this.TemplateService = new TemplateService(this.PowerShellContext);
 
             this.InstantiateAnalysisService();
 

src/PowerShellEditorServices/Templates/TemplateDetails.cs

@@ -0,0 +1,43 @@
+//
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+//
+
+namespace Microsoft.PowerShell.EditorServices.Templates
+{
+    /// <summary>
+    /// Provides details about a file or project template.
+    /// </summary>
+    public class TemplateDetails
+    {
+        /// <summary>
+        /// Gets or sets the title of the template.
+        /// </summary>
+        public string Title { get; set; }
+
+        /// <summary>
+        /// Gets or sets the author of the template.
+        /// </summary>
+        public string Author { get; set; }
+
+        /// <summary>
+        /// Gets or sets the version of the template.
+        /// </summary>
+        public string Version { get; set; }
+
+        /// <summary>
+        /// Gets or sets the description of the template.
+        /// </summary>
+        public string Description { get; set; }
+
+        /// <summary>
+        /// Gets or sets the template's comma-delimited string of tags.
+        /// </summary>
+        public string Tags { get; set; }
+
+        /// <summary>
+        /// Gets or sets the template's folder path.
+        /// </summary>
+        public string TemplatePath { get; set; }
+    }
+}