Add Optional Custom Variable Name to ConvertTo-SplatExpression (#25)

* Add custom variable naame for ConvertTo-SplatExpression

* Update ConvertTo-SplatExpression Documentation to include VariableName paramater

* Move comment closer to relevant code

* Add missing comma

Author: markekraus

docs/en-US/ConvertTo-SplatExpression.md

@@ -13,7 +13,7 @@ Convert a command expression to use splatting.
 ## SYNTAX
 
 ```powershell
-ConvertTo-SplatExpression [[-Ast] <Ast>]
+ConvertTo-SplatExpression [[-Ast] <Ast>] [[-VariableName] <String>]
 ```
 
 ## DESCRIPTION
@@ -60,6 +60,22 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -VariableName
+
+Specifies the Varabile name to use for the splat hashtable variable.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: none
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ## INPUTS
 
 ## OUTPUTS

module/Public/ConvertTo-SplatExpression.ps1

@@ -10,7 +10,10 @@ function ConvertTo-SplatExpression {
     [EditorCommand(DisplayName='Convert Command to Splat Expression')]
     param(
         [System.Management.Automation.Language.Ast]
-        $Ast
+        $Ast,
+        
+        [String]
+        $VariableName
     )
     begin {
         function ConvertFromExpressionAst($expression) {
@@ -63,12 +66,14 @@ function ConvertTo-SplatExpression {
             $splat.($parameter.Key) = $parameter.Value.Value
         }
 
-        # Remove the hypen, change to camelCase and add 'Splat'
-        $variableName = [regex]::Replace(
-            ($commandName.Extent.Text -replace '-'),
-            '^[A-Z]',
-            { $args[0].Value.ToLower() }) +
-            'Splat'
+        if (-not $VariableName) {
+            # Remove the hypen, change to camelCase and add 'Splat'
+            $variableName = [regex]::Replace(
+                ($commandName.Extent.Text -replace '-'),
+                '^[A-Z]',
+                { $args[0].Value.ToLower() }) +
+                'Splat'
+        }
 
         $sb = [System.Text.StringBuilder]::
             new('${0}' -f $variableName).