Adding [inherit] transpiler (Fixes #235)

Author: StartAutomating

docs/Inherit.md

@@ -0,0 +1,292 @@
+
+Inherit
+-------
+### Synopsis
+Inherits a Command
+
+---
+### Description
+
+Inherits a given command.  
+
+This acts similarily to inheritance in Object Oriented programming.
+
+By default, inheriting a function will join the contents of that function with the -ScriptBlock.
+
+Your ScriptBlock will come first, so you can override any of the behavior of the underlying command.    
+
+You can "abstractly" inherit a command, that is, inherit only the command's parameters.
+
+Inheritance can also be -Abstract.
+
+When you use Abstract inheritance, you get only the function definition and header from the inherited command.
+
+You can also -Override the command you are inheriting.
+
+This will add an [Alias()] attribute containing the original command name.
+
+One interesting example is overriding an application
+
+---
+### Examples
+#### EXAMPLE 1
+```PowerShell
+Invoke-PipeScript {
+    [inherit("Get-Command")]
+    param()
+}
+```
+
+#### EXAMPLE 2
+```PowerShell
+{
+    [inherit("gh",Overload)]
+    param()
+    begin { "ABOUT TO CALL GH"}
+    end { "JUST CALLED GH" }
+}.Transpile()
+```
+
+#### EXAMPLE 3
+```PowerShell
+# Inherit Get-Transpiler abstractly and make it output the parameters passed in.
+{
+    [inherit("Get-Transpiler", Abstract)]
+    param() process { $psBoundParameters }
+}.Transpile()
+```
+
+#### EXAMPLE 4
+```PowerShell
+{
+    [inherit("Get-Transpiler", Dynamic, Abstract)]
+    param()
+} | .>PipeScript
+```
+
+---
+### Parameters
+#### **Command**
+
+> **Type**: ```[String]```
+
+> **Required**: true
+
+> **Position**: 1
+
+> **PipelineInput**:false
+
+
+
+---
+#### **Abstract**
+
+If provided, will abstractly inherit a function.
+This include the function's parameters, but not it's content
+It will also define a variable within a dynamicParam {} block that contains the base command.
+
+
+
+> **Type**: ```[Switch]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **Override**
+
+If provided, will set an alias on the function to replace the original command.
+
+
+
+> **Type**: ```[Switch]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **Dynamic**
+
+If set, will dynamic overload commands.
+This will use dynamic parameters instead of static parameters, and will use a proxy command to invoke the inherited command.
+
+
+
+> **Type**: ```[Switch]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **Proxy**
+
+If set, will always inherit commands as proxy commands.
+This is implied by -Dynamic.
+
+
+
+> **Type**: ```[Switch]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **CommandType**
+
+The Command Type.  This can allow you to specify the type of command you are overloading.
+If the -CommandType includes aliases, and another command is also found, that command will be used.
+(this ensures you can continue to overload commands)
+
+
+
+> **Type**: ```[String[]]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **ExcludeBlockType**
+
+A list of block types to be excluded during a merge of script blocks.
+By default, no blocks will be excluded.
+
+
+
+Valid Values:
+
+* using
+* requires
+* help
+* header
+* param
+* dynamicParam
+* begin
+* process
+* end
+
+
+
+> **Type**: ```[String[]]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **IncludeBlockType**
+
+A list of block types to include during a merge of script blocks.
+
+
+
+Valid Values:
+
+* using
+* requires
+* help
+* header
+* param
+* dynamicParam
+* begin
+* process
+* end
+
+
+
+> **Type**: ```[String[]]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **IncludeParameter**
+
+A list of parameters to include.  Can contain wildcards.
+If -IncludeParameter is provided without -ExcludeParameter, all other parameters will be excluded.
+
+
+
+> **Type**: ```[String[]]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **ExcludeParameter**
+
+A list of parameters to exclude.  Can contain wildcards.
+Excluded parameters with default values will declare the default value at the beginnning of the command.
+
+
+
+> **Type**: ```[String[]]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:false
+
+
+
+---
+#### **ScriptBlock**
+
+> **Type**: ```[ScriptBlock]```
+
+> **Required**: false
+
+> **Position**: named
+
+> **PipelineInput**:true (ByValue)
+
+
+
+---
+### Syntax
+```PowerShell
+Inherit [-Command] <String> [-Abstract] [-Override] [-Dynamic] [-Proxy] [-CommandType <String[]>] [-ExcludeBlockType <String[]>] [-IncludeBlockType <String[]>] [-IncludeParameter <String[]>] [-ExcludeParameter <String[]>] [-ScriptBlock <ScriptBlock>] [<CommonParameters>]
+```
+---
+
+
+