Supporting Sponsorship (Fixes #488)

Author: James Brundage

PipeScript.psd1

@@ -10,7 +10,7 @@
     CompanyName       = 'Start-Automating'
     Copyright         = '2022 Start-Automating'
     Author            = 'James Brundage'
-    FunctionsToExport = 'Export-Pipescript','Get-PipeScript','Get-Transpiler','Import-PipeScript','Invoke-PipeScript','Join-PipeScript','New-PipeScript','Search-PipeScript','Update-PipeScript','Use-PipeScript','Protocol.HTTP','Protocol.JSONSchema','Protocol.OpenAPI','Protocol.UDP','PipeScript.Automatic.Variable.IsPipedTo','PipeScript.Automatic.Variable.IsPipedFrom','PipeScript.Automatic.Variable.MyCallstack','PipeScript.Automatic.Variable.MySelf','PipeScript.Automatic.Variable.MyParameters','PipeScript.Automatic.Variable.MyCaller','PipeScript.Automatic.Variable.MyCommandAst','Aspect.DynamicParameter','Aspect.ModuleExtensionType','Aspect.ModuleExtensionPattern','Aspect.ModuleExtensionCommand','PipeScript.Optimizer.ConsolidateAspects','PipeScript.PostProcess.InitializeAutomaticVariables','PipeScript.PostProcess.PartialFunction'
+    FunctionsToExport = 'Export-Pipescript','Get-PipeScript','Get-Transpiler','Import-PipeScript','Invoke-PipeScript','Join-PipeScript','New-PipeScript','Search-PipeScript','Update-PipeScript','Use-PipeScript','PipeScript.Automatic.Variable.IsPipedTo','PipeScript.Automatic.Variable.IsPipedFrom','PipeScript.Automatic.Variable.MyCallstack','PipeScript.Automatic.Variable.MySelf','PipeScript.Automatic.Variable.MyParameters','PipeScript.Automatic.Variable.MyCaller','PipeScript.Automatic.Variable.MyCommandAst','PipeScript.Optimizer.ConsolidateAspects','Protocol.HTTP','Protocol.JSONSchema','Protocol.OpenAPI','Protocol.UDP','Aspect.DynamicParameter','Aspect.ModuleExtensionType','Aspect.ModuleExtensionPattern','Aspect.ModuleExtensionCommand','PipeScript.PostProcess.InitializeAutomaticVariables','PipeScript.PostProcess.PartialFunction'
     PrivateData = @{
         FunctionTypes = @{
             'Partial' = @{

Transpilers/README.md

@@ -144,6 +144,15 @@ This directory includes uncategorized or 'common' transpilers.
     } | .>PipeScript
 ~~~
 
+#### Include Example 4
+
+
+~~~PowerShell
+    {
+        [Include('https://pssvg.start-automating.com/Examples/PowerShellChevron.svg')]$PSChevron
+    } | .>PipeScript
+~~~
+
 #### Inherit Example 1
 
 

docs/Include.md

@@ -44,6 +44,13 @@ Includes Files or Functions into a Script.
 } | .>PipeScript
 ```
 
+#### EXAMPLE 4
+```PowerShell
+{
+    [Include('https://pssvg.start-automating.com/Examples/PowerShellChevron.svg')]$PSChevron
+} | .>PipeScript
+```
+
 
 
 ---
@@ -59,9 +66,9 @@ The File Path to Include
 
 
 
-|Type      |Required|Position|PipelineInput|
-|----------|--------|--------|-------------|
-|`[String]`|true    |1       |false        |
+|Type      |Required|Position|PipelineInput|Aliases                 |
+|----------|--------|--------|-------------|------------------------|
+|`[String]`|false   |1       |false        |FullName<br/>Uri<br/>Url|
 
 
 
@@ -112,6 +119,12 @@ The exclusion pattern to use.
 
 #### **VariableAst**
 
+The variable that include will be applied to.
+If including files with wildcards, this will be the base path.
+Otherwise, this variable will be assigned to the included value.
+
+
+
 
 
 
@@ -123,6 +136,11 @@ The exclusion pattern to use.
 
 #### **CommandAst**
 
+The CommandAST.
+This is provided by the transpiler when include is used as a keyword.
+
+
+
 
 
 
@@ -139,8 +157,8 @@ The exclusion pattern to use.
 
 ### Syntax
 ```PowerShell
-Include [-FilePath] <String> [-AsByte] [-Passthru] [-Exclude <String[]>] -VariableAst <VariableExpressionAst> [<CommonParameters>]
+Include [[-FilePath] <String>] [-AsByte] [-Passthru] [-Exclude <String[]>] -CommandAst <CommandAst> [<CommonParameters>]
 ```
 ```PowerShell
-Include [-FilePath] <String> [-AsByte] [-Passthru] [-Exclude <String[]>] -CommandAst <CommandAst> [<CommonParameters>]
+Include [-FilePath] <String> [-AsByte] [-Passthru] [-Exclude <String[]>] -VariableAst <VariableExpressionAst> [<CommonParameters>]
 ```