Functions/GenXdev.Coding.PowerShell.Modules/Get-GenXDevModule.ps1
|
<##############################################################################
Part of PowerShell module : GenXdev.Coding.PowerShell.Modules Original cmdlet filename : Get-GenXDevModule.ps1 Original author : René Vaessen / GenXdev Version : 1.300.2025 ################################################################################ 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. ################################################################################> ############################################################################### <# .SYNOPSIS Retrieves all GenXDev modules from a specified path. .DESCRIPTION This function searches through a directory structure for GenXdev modules, excluding any with '.local' in the name. For each valid module found, it returns the most recent version folder (1.x) that contains a valid module manifest (.psd1) file. .PARAMETER Path The root directory to search for GenXdev modules. If not specified, defaults to the parent directory of the script's location. .EXAMPLE Get-GenXDevModule -Path "C:\PowerShell\Modules" .EXAMPLE Get-GenXDevModule "C:\PowerShell\Modules" #> function Get-GenXDevModule { [CmdletBinding()] param( ######################################################################## [Alias('RootPath', 'FullPath')] [parameter( Mandatory = $false, Position = 0, HelpMessage = 'The root path to search for GenXdev modules' )] [string] $Path ) begin { # if no path provided, navigate up 4 levels from script location if (-not $Path) { $Path = (Microsoft.PowerShell.Management\Get-Item -LiteralPath $PSScriptRoot).Parent.Parent.Parent.Parent.FullName } # log the path being searched Microsoft.PowerShell.Utility\Write-Verbose "Searching for GenXdev modules in: $Path" } process { # enumerate all directories starting with 'GenXdev' Microsoft.PowerShell.Management\Get-ChildItem -LiteralPath $Path -Filter "GenXdev*" -Directory | Microsoft.PowerShell.Core\ForEach-Object { # store module information for processing $moduleName = $_.Name $moduleRootPath = $_.FullName # skip modules containing '.local' in their name if ($moduleName.ToLowerInvariant().Contains('.local')) { Microsoft.PowerShell.Utility\Write-Verbose "Skipping local module: $moduleName" return } # find the highest numbered 1.x version directory with valid psd1 Microsoft.PowerShell.Management\Get-ChildItem -LiteralPath $moduleRootPath -Filter "1.*" -Directory | Microsoft.PowerShell.Utility\Sort-Object -Property Name -Descending | Microsoft.PowerShell.Utility\Select-Object -First 1 | Microsoft.PowerShell.Core\ForEach-Object { # verify existence of module manifest if (Microsoft.PowerShell.Management\Test-Path -LiteralPath "$($_.FullName)\$moduleName.psd1") { Microsoft.PowerShell.Utility\Write-Verbose "Found valid module: $moduleName in $($_.FullName)" $_ } } } } end { } } |