Add New-EditorFile

module/PowerShellEditorServices/Commands/PowerShellEditorServices.Commands.psd1

@@ -77,7 +77,8 @@ FunctionsToExport = @('Register-EditorCommand',
                       'Out-CurrentFile',
                       'Join-ScriptExtent',
                       'Test-ScriptExtent',
-                      'Open-EditorFile')
+                      'Open-EditorFile',
+                      'New-EditorFile')
 
 # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
 CmdletsToExport = @()

module/PowerShellEditorServices/Commands/Public/CmdletInterface.ps1

@@ -77,13 +77,111 @@ function Unregister-EditorCommand {
     }
 }
 
+<#
+.SYNOPSIS
+    Creates new files and opens them in your editor window
+.DESCRIPTION
+    Creates new files and opens them in your editor window
+.EXAMPLE
+    PS > New-EditorFile './foo.ps1'
+    Creates and opens a new foo.ps1 in your editor
+.EXAMPLE
+    PS > Get-Process | New-EditorFile proc.txt
+    Creates and opens a new foo.ps1 in your editor with the contents of the call to Get-Process
+.EXAMPLE
+    PS > Get-Process | New-EditorFile proc.txt -Force
+    Creates and opens a new foo.ps1 in your editor with the contents of the call to Get-Process. Overwrites the file if it already exists
+.INPUTS
+    Path
+    an array of files you want to open in your editor
+    Value
+    The content you want in the new files
+    Force
+    Overwrites a file if it exists
+#>
+function New-EditorFile {
+    [CmdletBinding()]
+    param(
+        [Parameter()]
+        [String[]]
+        [ValidateNotNullOrEmpty()]
+        $Path,
+
+        [Parameter(ValueFromPipeline=$true)]
+        $Value,
+
+        [Parameter()]
+        [switch]
+        $Force
+    )
+
+    begin {
+        $valueList = @()
+    }
+
+    process {
+        $valueList += $Value
+    }
+
+    end {
+        if ($Path) {
+            foreach ($fileName in $Path)
+            {
+                if (-not (Test-Path $fileName) -or $Force) {
+                    New-Item -Path $fileName -ItemType File | Out-Null
+
+                    if ($Path.Count -gt 1) {
+                        $preview = $false
+                    } else {
+                        $preview = $true
+                    }
+
+                    $psEditor.Workspace.OpenFile($fileName, $preview)
+                    $psEditor.GetEditorContext().CurrentFile.InsertText(($valueList | Out-String))
+                } else {
+                    $PSCmdlet.WriteError( (
+                        New-Object -TypeName System.Management.Automation.ErrorRecord -ArgumentList @(
+                            [System.IO.IOException]"The file '$fileName' already exists.",
+                            'NewEditorFileIOError',
+                            [System.Management.Automation.ErrorCategory]::WriteError,
+                            $fileName) ) )
+                }
+            }
+        } else {
+            $psEditor.Workspace.NewFile()
+            $psEditor.GetEditorContext().CurrentFile.InsertText(($valueList | Out-String))
+        }
+    }
+}
+
 function Open-EditorFile {
-    param([Parameter(Mandatory=$true)]$FilePaths)
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory=$true, ValueFromPipeline=$true)]
+        [ValidateNotNullOrEmpty()]
+        $Path
+    )
 
-    Get-ChildItem $FilePaths -File | ForEach-Object {
-        $psEditor.Workspace.OpenFile($_.FullName)
+    begin {
+        $Paths = @()
+    }
+
+    process {
+        $Paths += $Path
+    }
+
+    end {
+        if ($Paths.Count -gt 1) {
+            $preview = $false
+        } else {
+            $preview = $true
+        }
+
+        Get-ChildItem $Paths -File | ForEach-Object {
+            $psEditor.Workspace.OpenFile($_.FullName, $preview)
+        }
     }
 }
 Set-Alias psedit Open-EditorFile -Scope Global
 
-Export-ModuleMember -Function Open-EditorFile
+Export-ModuleMember -Function Open-EditorFile,New-EditorFile

src/PowerShellEditorServices.Protocol/LanguageServer/EditorCommands.cs

@@ -111,8 +111,15 @@ public static readonly
     public class OpenFileRequest
     {
         public static readonly
-            RequestType<string, EditorCommandResponse, object, object> Type =
-            RequestType<string, EditorCommandResponse, object, object>.Create("editor/openFile");
+        RequestType<OpenFileDetails, EditorCommandResponse, object, object> Type =
+            RequestType<OpenFileDetails, EditorCommandResponse, object, object>.Create("editor/openFile");
+    }
+
+    public class OpenFileDetails
+    {
+        public string FilePath { get; set; }
+
+        public bool Preview { get; set; }
     }
 
     public class CloseFileRequest

src/PowerShellEditorServices.Protocol/Server/LanguageServerEditorOperations.cs

@@ -12,6 +12,8 @@ namespace Microsoft.PowerShell.EditorServices.Protocol.Server
 {
     internal class LanguageServerEditorOperations : IEditorOperations
     {
+        private const bool DefaultPreviewSetting = true;
+
         private EditorSession editorSession;
         private IMessageSender messageSender;
 
@@ -115,7 +117,24 @@ public Task OpenFile(string filePath)
             return
                 this.messageSender.SendRequest(
                     OpenFileRequest.Type,
-                    filePath,
+                    new OpenFileDetails
+                    {
+                        FilePath = filePath,
+                        Preview = DefaultPreviewSetting
+                    },
+                    true);
+        }
+
+        public Task OpenFile(string filePath, bool preview)
+        {
+            return
+                this.messageSender.SendRequest(
+                    OpenFileRequest.Type,
+                    new OpenFileDetails
+                    {
+                        FilePath = filePath,
+                        Preview = preview
+                    },
                     true);
         }
 

src/PowerShellEditorServices/Extensions/EditorWorkspace.cs

@@ -58,6 +58,18 @@ public void OpenFile(string filePath)
             this.editorOperations.OpenFile(filePath).Wait();
         }
 
+        /// <summary>
+        /// Opens a file in the workspace.  If the file is already open
+        /// its buffer will be made active.
+        /// You can specify whether the file opens as a preview or as a durable editor.
+        /// </summary>
+        /// <param name="filePath">The path to the file to be opened.</param>
+        /// <param name="preview">Determines wether the file is opened as a preview or as a durable editor.</param>
+        public void OpenFile(string filePath, bool preview)
+        {
+            this.editorOperations.OpenFile(filePath, preview).Wait();
+        }
+
         #endregion
     }
 }

src/PowerShellEditorServices/Extensions/IEditorOperations.cs

@@ -47,6 +47,16 @@ public interface IEditorOperations
         /// <returns>A Task that can be tracked for completion.</returns>
         Task OpenFile(string filePath);
 
+        /// <summary>
+        /// Causes a file to be opened in the editor.  If the file is
+        /// already open, the editor must switch to the file.
+        /// You can specify whether the file opens as a preview or as a durable editor.
+        /// </summary>
+        /// <param name="filePath">The path of the file to be opened.</param>
+        /// <param name="preview">Determines wether the file is opened as a preview or as a durable editor.</param>
+        /// <returns>A Task that can be tracked for completion.</returns>
+        Task OpenFile(string filePath, bool preview);
+
         /// <summary>
         /// Causes a file to be closed in the editor.
         /// </summary>