Updates PowerShell and PipeScript ScriptBlocks

Updates ScriptBlocks written in PowerShell or PipeScript. Also updates blocks of text.

Update-PipeScript is used by PipeScript transpilers in order to make a number of changes to a script.

It can also be used interactively to transform scripts or text in a number of ways.

EXAMPLE 1

Update-PipeScript -ScriptBlock {
    param($x,$y)
} -RemoveParameter x

EXAMPLE 2

Update-PipeScript -RenameVariable @{x='y'} -ScriptBlock {$x}

EXAMPLE 3

Update-PipeScript -ScriptBlock {
    #region MyRegion
    1
    #endregion MyRegion
    2
} -RegionReplacement @{MyRegion=''}

A Script Block, written in PowerShell or PipeScript.

A block of text.

Replaces sections within text. -TextReplacement is a dictionary of replacements. Keys in the dictionary must be a string describing a character range, in the form start,end.

If set, will replace items based off of the abstract syntax tree.

If provided, will replace regular expression matches.

If provided, will replace regions.

If provided, will remove one or more parameters from a ScriptBlock.

If provided, will insert text before any regular epxression match.

If provided, will insert text after any regular expression match.

A dictionary of items to insert after an AST element.

A dictionary of items to insert before an AST element.

A dictionary of items to insert at the start of another item's AST block. The key should be an AST element. The nearest block start will be the point that the item is inserted.

A dictionary of items to insert at the start of another item's AST block. The key should be an AST element. The nearest block end will be the point that the item is inserted.

A dictionary of text insertions. The key is the insertion index. The value is the insertion.

A dictionary of regex based insertions This works similarly to -RegexReplacement.

A collection of variables to rename.

Content to append. Appended ScriptBlocks will be added to the last block of a ScriptBlock. Appended Text will be added to the end.

Content to prepend Prepended ScriptBlocks will be added to the first block of a ScriptBlock. Prepended text will be added at the start.

If set, will transpile the updated script block.

Update-PipeScript [[-ScriptBlock] <ScriptBlock>] [[-Text] <String>] [[-TextReplacement] <IDictionary>] [[-AstReplacement] <IDictionary>] [[-AstCondition] <IDictionary>] [[-RegexReplacement] <IDictionary>] [[-RegionReplacement] <IDictionary>] [[-RemoveParameter] <String[]>] [[-InsertBefore] <IDictionary>] [[-InsertAfter] <IDictionary>] [[-InsertAfterAST] <IDictionary>] [[-InsertBeforeAst] <IDictionary>] [[-InsertBlockStart] <IDictionary>] [[-InsertBlockEnd] <IDictionary>] [[-TextInsertion] <IDictionary>] [[-RegexInsertion] <IDictionary>] [[-RenameVariable] <IDictionary>] [[-Append] <Object>] [[-Prepend] <Object>] [-Transpile] [<CommonParameters>]