Public/Get-PSSEnvironment.ps1

<#
    .SYNOPSIS
        Retrieves information about PS.Severance environments.
 
    .DESCRIPTION
        This function retrieves information about PS.Severance environments.
        If the 'Environment' parameter is specified, it retrieves details for that specific environment.
        If the 'Environment' parameter is not specified, it retrieves details for all environments.
 
    .PARAMETER Environment
        The name of the environment to retrieve. If not specified, all environments are retrieved.
 
    .EXAMPLE
        Get-PSSEnvironment -Environment "Dev"
 
        Retrieves information about the "Dev" environment.
 
    .EXAMPLE
        Get-PSSEnvironment
 
        Retrieves information about all environments.
#>

Function Get-PSSEnvironment {
    Param (
    [Parameter(Mandatory=$false)]
    [string]$Environment
    )

    if ($Environment) {
        # Logic to get the environment by name
        $EnvPath = "$ENV:PSSEnvRoot\$Environment"

        $Environment = Get-Item -Path $EnvPath -ErrorAction SilentlyContinue
        if ($Environment) {
            $EnvVariables = Get-Content -Path "$EnvPath\Environment_Variables.json"

            $EnvData = [pscustomobject]@{
                Name = $Environment
                Path = $EnvPath
                Variables = $EnvVariables | ConvertFrom-Json
            }
            return $EnvData
        }
        else {
            Write-Warning "Environment '$Environment' not found."
        }
    }
    else {
        # Logic to get all environments
        $Environments = Get-ChildItem -Path "$ENV:PSSEnvRoot" -Directory
        $EnvDataList = New-Object System.Collections.ArrayList
        foreach ($Env in $Environments) {
            $EnvPath = $Env.FullName
            $EnvVariables = Get-Content -Path "$EnvPath\Environment_Variables.json" -ErrorAction SilentlyContinue
            $EnvData = [pscustomobject]@{
                Name = $Env.Name
                Path = $EnvPath
                Variables = $EnvVariables | ConvertFrom-Json
            }
            [void]$EnvDataList.Add($EnvData)
        }
        return $EnvDataList
    }
}