New-ForgeScript.ps1

<#
Copyright 2016 Dominique Broeglin

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 New-ForgeScript {
    <#
    .SYNOPSIS
        Creates a new script.

    .DESCRIPTION
        Creates a new skeleton script based on the arguments passed to the function.

    .EXAMPLE
        New-ForgeScript -Name MyScript -Parameters a,b,c

    .PARAMETER Name
        The name of the new script.

    .PARAMETER Parameter
        An array of parameter names for the new script.

    #>

    [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact='Low')]
    Param(
        [Parameter(Mandatory = $true)]
        [String]$Name,

        [Parameter()]
        [String]$Path,

        [Parameter()]
        [String[]]$Parameter = @()
    )
    Begin {
        # TODO: this can be simplified, refactor to create a better example
        if ($Path) {
            if (Test-Path -Type Container -Path $Path) {
                $DestinationPath = $Path
                $Path = "$Name.psd1"
            } else {
                $DestinationPath = Split-Path -Parent -Path $Path
                $Path = Split-Path -Leaf -Path $Path
            }
        } else {
            $DestinationPath = $PWD
            $Path = "$Name.ps1"
        }
        Initialize-ForgeContext -SourceRoot (Join-Path $PSScriptRoot "Templates") `
            -DestinationPath $DestinationPath `
            -Binding @{
                Name       = $Name
                Parameters = $Parameter
            }
    }
    Process {
        if (!$PSCmdlet.ShouldProcess($Name, "Create script")) {
            return
        }

        Copy-ForgeFile -Source "Script.ps1" -Destination $Path 
    }
}