init

src/DynamicParams/header.ps1

@@ -0,0 +1,4 @@
+[Diagnostics.CodeAnalysis.SuppressMessageAttribute(
+    'PSAvoidLongLines', '', Justification = 'Contains long links.')]
+[CmdletBinding()]
+param()

src/DynamicParams/public/New-DynamicParam.ps1

@@ -0,0 +1,227 @@
+function New-DynamicParam {
+    <#
+        .SYNOPSIS
+        Creates a new dynamic parameter for a function.
+
+        .DESCRIPTION
+        Creates a new dynamic parameter for a function.
+
+        .EXAMPLE
+        DynamicParam {
+            $DynamicParamDictionary = New-DynamicParamDictionary
+
+            $dynParam = @{
+                Name                   = 'GitignoreTemplate'
+                Alias                  = 'gitignore_template'
+                Type                   = [string]
+                ValidateSet            = Get-GitHubGitignoreList
+                DynamicParamDictionary = $DynamicParamDictionary
+            }
+            New-DynamicParam @dynParam
+
+            $dynParam2 = @{
+                Name                   = 'LicenseTemplate'
+                Alias                  = 'license_template'
+                Type                   = [string]
+                ValidateSet            = Get-GitHubLicenseList | Select-Object -ExpandProperty key
+                DynamicParamDictionary = $DynamicParamDictionary
+            }
+            New-DynamicParam @dynParam2
+
+            return $DynamicParamDictionary
+        }
+
+        .NOTES
+        https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_functions_advanced_parameters?view=powershell-7.3#psdefaultvalue-attribute-arguments
+
+        #Default Value
+        # https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_functions_advanced_parameters?view=powershell-7.3#psdefaultvalue-attribute-arguments
+        # https://learn.microsoft.com/en-us/dotnet/api/system.management.automation.runtimedefinedparameter.value?view=powershellsdk-7.3.0
+    #>
+    [OutputType([void])]
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
+        'PSAvoidLongLines', '', Justification = 'Long links'
+    )]
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
+        'PSUseShouldProcessForStateChangingFunctions', '',
+        Justification = 'Function does not change state.'
+    )]
+    [CmdletBinding()]
+    param(
+        # Specifies the name of the parameter.
+        [Parameter(Mandatory)]
+        [string] $Name,
+
+        # Specifies the aliases of the parameter.
+        [Parameter()]
+        [string[]] $Alias,
+
+        # Specifies the data type of the parameter.
+        [Parameter()]
+        [type] $Type,
+
+        # Specifies the parameter set name.
+        [Parameter()]
+        [string] $ParameterSetName = '__AllParameterSets',
+
+        # Specifies if the parameter is mandatory.
+        # Parameter Set specific
+        [Parameter()]
+        [switch] $Mandatory,
+
+        # Specifies the parameters positional binding.
+        # Parameter Set specific
+        [Parameter()]
+        [int] $Position,
+
+        # Specifies if the parameter accepts values from the pipeline.
+        # Parameter Set specific
+        [Parameter()]
+        [switch] $ValueFromPipeline,
+
+        # Specifies if the parameter accepts values from the pipeline by property name.
+        # Parameter Set specific
+        [Parameter()]
+        [switch] $ValueFromPipelineByPropertyName,
+
+        # Specifies if the parameter accepts values from the remaining command line arguments that are not associated with another parameter.
+        # Parameter Set specific
+        [Parameter()]
+        [switch] $ValueFromRemainingArguments,
+
+        # Specifies the help message of the parameter.
+        # Parameter Set specific
+        [Parameter()]
+        [string] $HelpMessage,
+
+        # Specifies the comments of the parameter.
+        [Parameter()]
+        [string] $Comment,
+
+        # Specifies the validate script of the parameter.
+        [Parameter()]
+        [scriptblock] $ValidateScript,
+
+        # Specifies the validate regex pattern of the parameter.
+        [Parameter()]
+        [regex] $ValidatePattern,
+
+        # Specifies the validate number of items for the parameter.
+        [Parameter()]
+        [ValidateCount(2, 2)]
+        [int[]] $ValidateCount,
+
+        # Specifies the validate range of the parameter.
+        [Parameter()]
+        [object] $ValidateRange,
+
+        # Specifies the validate set of the parameter.
+        [Parameter()]
+        [object] $ValidateSet,
+
+        # Specifies the validate length of the parameter.
+        [Parameter()]
+        [ValidateCount(2, 2)]
+        [int[]] $ValidateLength,
+
+        # Specifies if the parameter accepts null or empty values.
+        [Parameter()]
+        [switch] $ValidateNotNullOrEmpty,
+
+        # Specifies if the parameter accepts wildcards.
+        [Parameter()]
+        [switch] $SupportsWildcards,
+
+        # Specifies if the parameter accepts empty strings.
+        [Parameter()]
+        [switch] $AllowEmptyString,
+
+        # Specifies if the parameter accepts null values.
+        [Parameter()]
+        [switch] $AllowNull,
+
+        # Specifies if the parameter accepts empty collections.
+        [Parameter()]
+        [switch] $AllowEmptyCollection,
+
+        # Specifies the dynamic parameter dictionary.
+        [Parameter()]
+        [System.Management.Automation.RuntimeDefinedParameterDictionary] $DynamicParamDictionary
+    )
+
+    $attributeCollection = New-Object System.Collections.ObjectModel.Collection[System.Attribute]
+
+    # foreach ParameterSet in ParameterSets , Key = name, Value = Hashtable
+    $parameterAttribute = [System.Management.Automation.ParameterAttribute]::new()
+
+    $parameterAttribute.ParameterSetName = $ParameterSetName
+    if ($PSBoundParameters.ContainsKey('HelpMessage')) {
+        $parameterAttribute.HelpMessage = $HelpMessage
+    }
+    if ($PSBoundParameters.ContainsKey('Position')) {
+        $parameterAttribute.Position = $Position
+    }
+    $parameterAttribute.Mandatory = $Mandatory
+    $parameterAttribute.ValueFromPipeline = $ValueFromPipeline
+    $parameterAttribute.ValueFromPipelineByPropertyName = $ValueFromPipelineByPropertyName
+    $parameterAttribute.ValueFromRemainingArguments = $ValueFromRemainingArguments
+    $attributeCollection.Add($parameterAttribute)
+
+    if ($PSBoundParameters.ContainsKey('Alias')) {
+        $Alias | ForEach-Object {
+            $aliasAttribute = New-Object System.Management.Automation.AliasAttribute($_)
+            $attributeCollection.Add($aliasAttribute)
+        }
+    }
+
+    # TODO: Add ability to add a param doc/comment
+
+    if ($PSBoundParameters.ContainsKey('ValidateSet')) {
+        $validateSetAttribute = New-Object System.Management.Automation.ValidateSetAttribute($ValidateSet)
+        $attributeCollection.Add($validateSetAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('ValidateNotNullOrEmpty')) {
+        $validateSetAttribute = New-Object System.Management.Automation.ValidateNotNullOrEmptyAttribute
+        $attributeCollection.Add($validateSetAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('ValidateLength')) {
+        $validateLengthAttribute = New-Object System.Management.Automation.ValidateLengthAttribute($ValidateLength[0], $ValidateLength[1])
+        $attributeCollection.Add($validateLengthAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('ValidateCount')) {
+        $validateCountAttribute = New-Object System.Management.Automation.ValidateCountAttribute($ValidateCount[0], $ValidateCount[1])
+        $attributeCollection.Add($validateCountAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('ValidateScript')) {
+        $validateScriptAttribute = New-Object System.Management.Automation.ValidateScriptAttribute($ValidateScript)
+        $attributeCollection.Add($validateScriptAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('ValidatePattern')) {
+        $validatePatternAttribute = New-Object System.Management.Automation.ValidatePatternAttribute($ValidatePattern)
+        $attributeCollection.Add($validatePatternAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('ValidateRange')) {
+        $validateRangeAttribute = New-Object System.Management.Automation.ValidateRangeAttribute($ValidateRange)
+        $attributeCollection.Add($validateRangeAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('SupportsWildcards')) {
+        $supportsWildcardsAttribute = New-Object System.Management.Automation.SupportsWildcardsAttribute
+        $attributeCollection.Add($supportsWildcardsAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('AllowEmptyString')) {
+        $allowEmptyStringAttribute = New-Object System.Management.Automation.AllowEmptyStringAttribute
+        $attributeCollection.Add($allowEmptyStringAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('AllowNull')) {
+        $allowNullAttribute = New-Object System.Management.Automation.AllowNullAttribute
+        $attributeCollection.Add($allowNullAttribute)
+    }
+    if ($PSBoundParameters.ContainsKey('AllowEmptyCollection')) {
+        $allowEmptyCollectionAttribute = New-Object System.Management.Automation.AllowEmptyCollectionAttribute
+        $attributeCollection.Add($allowEmptyCollectionAttribute)
+    }
+
+    $runtimeDefinedParameter = New-Object System.Management.Automation.RuntimeDefinedParameter($Name, $Type, $attributeCollection)
+    $DynamicParamDictionary.Add($Name, $runtimeDefinedParameter)
+
+}

src/DynamicParams/public/New-DynamicParamDictionary.ps1

@@ -0,0 +1,23 @@
+function New-DynamicParamDictionary {
+    <#
+        .SYNOPSIS
+        Creates a new RuntimeDefinedParameterDictionary
+
+        .DESCRIPTION
+        Creates a new RuntimeDefinedParameterDictionary
+
+        .EXAMPLE
+        New-DynamicParamDictionary
+
+        Returns a new RuntimeDefinedParameterDictionary
+    #>
+    [OutputType([System.Management.Automation.RuntimeDefinedParameterDictionary])]
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
+        'PSUseShouldProcessForStateChangingFunctions', '',
+        Justification = 'Function does not change state.'
+    )]
+    [CmdletBinding()]
+    param()
+
+    return [System.Management.Automation.RuntimeDefinedParameterDictionary]::new()
+}