Functions/GenXdev.Coding.Templating/Add-ArrayTemplate.ps1
|
<##############################################################################
Part of PowerShell module : GenXdev.Coding.Templating Original cmdlet filename : Add-ArrayTemplate.ps1 Original author : René Vaessen / GenXdev Version : 2.3.2026 ################################################################################ Copyright (c) René Vaessen / GenXdev Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ################################################################################> function Add-ArrayTemplate { [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseSingularNouns', '')] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '')] [Alias('FormatArray')] [OutputType([string])] param( ########################################################################### [Parameter( Mandatory = $true, Position = 0, ValueFromPipeline = $true, HelpMessage = "The collection of objects to format" )] [System.Collections.IEnumerable] $InputObject, ########################################################################### [Parameter( Mandatory = $true, Position = 1, HelpMessage = ( "The template string with {PropertyName} or " + "{PropertyName:format} placeholders" ) )] [string] $Template, ########################################################################### [Parameter( Mandatory = $false, Position = 2, HelpMessage = ( "The delimiter string to insert between formatted items" ) )] [string] $Delimiter = "`n", ########################################################################### [Parameter( Mandatory = $false, Position = 3, HelpMessage = ( "The number of indentation levels (4 spaces per level) to apply" ) )] [int] $Indentation = 0, ########################################################################### [Parameter( Mandatory = $false, Position = 4, HelpMessage = "Appends a trailing delimiter after the final item" )] [switch] $NewLine = $false, ########################################################################### [Parameter( Mandatory = $false, Position = 5, HelpMessage = "Add delimiter at end when array not empty" )] [switch] $EndDelimiter = $false ########################################################################### ) begin { # calculate the indentation string based on the specified level $indent = ' ' * $Indentation # create a string builder for efficient string concatenation $sb = [System.Text.StringBuilder]::new() # track whether this is the first item to avoid leading delimiter $first = $true } process { # iterate through each object in the input collection foreach ($item in $InputObject) { if ($null -eq $item) { continue } # add delimiter before all items except the first one if (-not $first) { $null = $sb.Append($Delimiter) if ($NewLine) { $null = $sb.Append("`r`n$indent") } } # mark that we've processed the first item $first = $false # If the item is a scalar (not an object with properties), use an empty hashtable if ($item -is [PSObject]) { $item = $item.PSObject.BaseObject } if ($item -is [string] -or $item -is [int] -or $item -is [double] -or $item -is [bool] -or $item -is [char] -or $item -is [datetime]) { } elseif ($item -is [hashtable]) { $hash = $item } else { $hash = $item | GenXdev.Helpers\ConvertTo-Hashtable } # Expand template inside an isolated scope $expanded = & { param($template, $hash, $item) if ($item -is [PSObject]) { $item = $item.PSObject.BaseObject } if ($item -is [string] -or $item -is [int] -or $item -is [double] -or $item -is [bool] -or $item -is [char] -or $item -is [datetime]) { $template = $template.Replace('$PSItem', '$item').Replace('$_', '$item') } else { foreach ($entry in $hash.GetEnumerator()) { Microsoft.PowerShell.Utility\Set-Variable -Name $entry.Key -Value $entry.Value -ErrorAction SilentlyContinue } } $ExecutionContext.InvokeCommand.ExpandString($template) } $template $hash $item # Add delimiter between items (but not after last) $null = $sb.Append($expanded) } } end { # append trailing delimiter if requested and output is not empty if ((-not $first) -and ($endDelimiter)) { $null = $sb.Append($Delimiter) if ($NewLine) { $null = $sb.Append("`r`n$indent") } } # return the fully formatted string return $sb.ToString() } } ################################################################################ |