Adding Support for PipeScript in Bash (Fixes #194)

Author: James Brundage

Transpilers/Inline/Inline.Bash.psx.ps1

@@ -0,0 +1,78 @@
+<#
+.SYNOPSIS
+    Bash PipeScript Transpiler.
+.DESCRIPTION
+    Transpiles Bash with Inline PipeScript into Bash.
+
+    Heredocs named PipeScript{} will be treated as blocks of PipeScript.
+
+    ```bash
+    <<PipeScript{}
+    
+    # This will be considered PipeScript / PowerShell, and will return the contents of a bash script.
+
+    PipeScript{}
+    ```
+.EXAMPLE
+    Invoke-PipeScript {
+        $bashScript = @'
+        echo 'hello world'
+
+        <<PipeScript{}
+            "echo '$('hi','yo','sup' | Get-Random)'"
+        PipeScript{}
+    '@
+    
+        [OutputFile('.\HelloWorld.ps1.sh')]$bashScript
+    }
+
+    Invoke-PipeScript .\HelloWorld.ps1.sh
+#>
+[ValidateScript({
+    $cmdInfo = $_
+    if ($cmdInfo.Source -match '\.sh$') {
+        return $true
+    }
+    return $false    
+})]
+param(
+# The command information.  This will include the path to the file.
+[Parameter(Mandatory,ValueFromPipeline)]
+[Management.Automation.CommandInfo]
+$CommandInfo,
+
+# A dictionary of parameters.
+[Collections.IDictionary]
+$Parameter,
+
+# A list of arguments.
+[PSObject[]]
+$ArgumentList
+)
+
+begin {
+    # We start off by declaring a number of regular expressions:
+    $startComment = '(?>\<\<PipeScript\{\})' 
+    $endComment   = '(?>PipeScript\{\})'    
+    # * StartRegex     ```$StartComment + '{' + $Whitespace```
+    $startRegex = "(?<PSStart>${startComment})"
+    # * EndRegex       ```$whitespace + '}' + $EndComment```
+    $endRegex   = "(?<PSEnd>${endComment})"
+
+    # Create a splat containing arguments to the core inline transpiler
+    $Splat      = [Ordered]@{
+        StartPattern  = $startRegex
+        EndPattern    = $endRegex
+    }
+}
+
+process {
+    # Add parameters related to the file
+    $Splat.SourceFile = $commandInfo.Source -as [IO.FileInfo]
+    $Splat.SourceText = [IO.File]::ReadAllText($commandInfo.Source)
+    if ($Parameter) { $splat.Parameter = $Parameter }
+    if ($ArgumentList) { $splat.ArgumentList = $ArgumentList }
+
+    # Call the core inline transpiler.
+    .>PipeScript.Inline @Splat
+}