add Save to FileContext API

Author: TylerLeonhardt

src/PowerShellEditorServices.Protocol/LanguageServer/EditorCommands.cs

@@ -122,6 +122,13 @@ public static readonly
             RequestType<string, EditorCommandResponse, object, object>.Create("editor/closeFile");
     }
 
+    public class SaveFileRequest
+    {
+        public static readonly
+            RequestType<string, EditorCommandResponse, object, object> Type =
+            RequestType<string, EditorCommandResponse, object, object>.Create("editor/saveFile");
+    }
+
     public class ShowInformationMessageRequest
     {
         public static readonly

src/PowerShellEditorServices.Protocol/Server/LanguageServerEditorOperations.cs

@@ -128,6 +128,15 @@ public Task CloseFile(string filePath)
                     true);
         }
 
+        public Task SaveFile(string filePath)
+        {
+            return
+                this.messageSender.SendRequest(
+                    SaveFileRequest.Type,
+                    filePath,
+                    true);
+        }
+
         public string GetWorkspacePath()
         {
             return this.editorSession.Workspace.WorkspacePath;

src/PowerShellEditorServices/Extensions/FileContext.cs

@@ -228,6 +228,18 @@ public void InsertText(string textToInsert, BufferRange insertRange)
         }
 
         #endregion
+
+        #region File Manipulation
+
+        /// <summary>
+        /// Saves this file.
+        /// </summary>
+        public void Save()
+        {
+            this.editorOperations.SaveFile(this.scriptFile.FilePath);
+        }
+
+        #endregion
     }
 }
 

src/PowerShellEditorServices/Extensions/IEditorOperations.cs

@@ -54,6 +54,13 @@ public interface IEditorOperations
         /// <returns>A Task that can be tracked for completion.</returns>
         Task CloseFile(string filePath);
 
+        /// <summary>
+        /// Causes a file to be saved in the editor.
+        /// </summary>
+        /// <param name="filePath">The path of the file to be saved.</param>
+        /// <returns>A Task that can be tracked for completion.</returns>
+        Task SaveFile(string filePath);
+
         /// <summary>
         /// Inserts text into the specified range for the file at the specified path.
         /// </summary>

test/PowerShellEditorServices.Test/Extensions/ExtensionServiceTests.cs

@@ -200,6 +200,11 @@ public Task CloseFile(string filePath)
             throw new NotImplementedException();
         }
 
+        public Task SaveFile(string filePath)
+        {
+            throw new NotImplementedException();
+        }
+
         public Task InsertText(string filePath, string text, BufferRange insertRange)
         {
             throw new NotImplementedException();