🧑‍💻 Support importing character constants with aliases

Author: brianary

Import-CharConstants.ps1

@@ -24,7 +24,10 @@ Creates constants in the context of the current script for the named characters.
 [CmdletBinding()] Param(
 # The control code abbreviation, Unicode name, HTML entity, or GitHub name of the character to create a constant for.
 # "NL" will use the newline appropriate to the environment.
-[Parameter(Position=0,Mandatory=$true,ValueFromPipeline=$true,ValueFromRemainingArguments=$true)][string[]] $CharacterName,
+[Parameter(ParameterSetName='UseNames',Position=0,Mandatory=$true,ValueFromPipeline=$true,ValueFromRemainingArguments=$true)][string[]] $CharacterName,
+# A dictionary that maps character variable name aliases to control code abbreviations, Unicode names, HTML entities,
+# or GitHub names of characters.
+[Parameter(ParameterSetName='UseAliases',Mandatory=$true)][hashtable] $Alias,
 # The scope of the constant.
 [string] $Scope = 'Local',
 <#
@@ -33,13 +36,25 @@ for characters that support both a simple text presentation as well as a color e
 #>
 [switch] $AsEmoji
 )
-Begin {$level = Add-ScopeLevel.ps1 -Scope $Scope}
+Begin
+{
+    $level = $Scope |Add-ScopeLevel.ps1 |Add-ScopeLevel.ps1
+
+    filter Add-CharacterConstant
+    {
+        [CmdletBinding()] Param(
+        [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)][Alias('Key')][string] $Alias,
+        [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)][Alias('Value')][string] $CharacterName
+        )
+        $char = $CharacterName -eq 'NL' ? [Environment]::NewLine : (Get-UnicodeByName.ps1 -Name $CharacterName -AsEmoji:$AsEmoji)
+        Set-Variable -Name ($Alias.Trim(':')) -Value $char -Scope $level -Option Constant -Description $CharacterName
+    }
+}
 Process
 {
-    foreach($name in $CharacterName)
+    switch($PSCmdlet.ParameterSetName)
     {
-        $cname = $name -replace ':'
-        $value = $name -ceq 'NL' ? [Environment]::NewLine : (Get-UnicodeByName.ps1 -Name $name -AsEmoji:$AsEmoji)
-        Set-Variable -Name $cname -Value $value -Scope $level -Option Constant -Description $name
+        UseNames {$CharacterName |Add-CharacterConstant}
+        UseAliases {$Alias.GetEnumerator() |Add-CharacterConstant}
     }
 }

Show-Status.ps1

@@ -2,6 +2,9 @@
 .SYNOPSIS
 Displays requested system status values using powerline font characters.
 
+.LINK
+https://www.nerdfonts.com/cheat-sheet
+
 .LINK
 Get-Unicode.ps1
 
@@ -20,7 +23,7 @@ Show-Status.ps1 UserName HomeDirectory -Separator ' * '
 # The format to serialize the date as.
 [Parameter(Position=0,Mandatory=$true,ValueFromRemainingArguments=$true)]
 [ValidateSet('AdminIndicator','ComputerName','DotNetVersion','DriveUsage','ExplorerUser','GitUser','HomeDirectory',
-'OSVersion','PowerShellCommand','PowerShellVersion','Uptime','UserName')]
+'OSVersion','PowerShellCommand','PowerShellVersion','Updates','Uptime','UserName')]
 [string[]] $Status,
 # The separator to use between formatted dates.
 [string] $Separator = " $(Get-Unicode.ps1 0x2022) ",
@@ -31,21 +34,30 @@ Show-Status.ps1 UserName HomeDirectory -Separator ' * '
 )
 Begin
 {
-    Import-CharConstants.ps1 'BUST IN SILHOUETTE' 'HOUSE BUILDING' 'SQUARED ID' 'PERSONAL COMPUTER' `
-        'POWER SYMBOL' 'NEW MOON SYMBOL' 'HARD DISK' 'POLICE CARS REVOLVING LIGHT' -AsEmoji
+    Import-CharConstants.ps1 -Alias @{
+        USER       = 'BUST IN SILHOUETTE'
+        HOUSE      = 'HOUSE BUILDING'
+        COMPUTER   = 'PERSONAL COMPUTER'
+        REDCIRCLE  = 'LARGE RED CIRCLE'
+        BLUECIRCLE = 'LARGE BLUE CIRCLE'
+        POWER      = 'POWER SYMBOL'
+        HARDDISK   = 'HARD DISK'
+        OVERLAP    = 'OVERLAP'
+        'UP!'      = 'SQUARED UP WITH EXCLAMATION MARK'
+    } -AsEmoji
     filter Format-Status
     {
         [CmdletBinding()][OutputType([string])] Param(
         [Parameter(ValueFromPipeline=$true)][string] $Status
         )
         switch($Status)
         {
-            AdminIndicator { (Test-Administrator.ps1) ? ${POLICE CARS REVOLVING LIGHT} : '' }
-            ComputerName {"${PERSONAL COMPUTER}$([Environment]::MachineName)"}
-            DotNetVersion {"$(Get-Unicode.ps1 0xE77F).NET $([Environment]::Version)"}
+            AdminIndicator { (Test-Administrator.ps1) ? $REDCIRCLE : $BLUECIRCLE }
+            ComputerName {"$COMPUTER $([Environment]::MachineName)"}
+            DotNetVersion {"$(Get-Unicode.ps1 0xE77F) .NET $([Environment]::Version)"}
             DriveUsage
             {
-                ${HARD DISK} + ' ' + ((Get-PSDrive -PSProvider FileSystem |
+                $HARDDISK + ' ' + ((Get-PSDrive -PSProvider FileSystem |Where-Object {$null -ne $_.Free} |
                     ForEach-Object {"$(Get-Unicode.ps1 (0x1F311 + [math]::Round((5*$_.Used)/($_.Used+$_.Free)) ))$($_.Name)"}) -join ' ')
             }
             ExplorerUser
@@ -55,22 +67,29 @@ Begin
                     ForEach-Object {$_.Get()} |
                     ForEach-Object {$_.GetOwner()} |
                     Select-Object -ExpandProperty User
-                "${SQUARED ID} $euser"
+                "$OVERLAP $euser"
             }
-            GitUser {"$(Get-Unicode.ps1 0xF1D2)$(git config user.name) <$(git config user.email)>"}
-            HomeDirectory {"${HOUSE BUILDING}$HOME"}
+            GitUser {"$(Get-Unicode.ps1 0xF1D2) $(git config user.name) <$(git config user.email)>"}
+            HomeDirectory {"$HOUSE $HOME"}
             OSVersion
             {
                 $icon =
                     if($IsWindows) {Get-Unicode.ps1 0xF17A}
                     elseif($IsLinux) {Get-Unicode.ps1 0xF17C}
                     elseif($IsMacOS) {Get-Unicode.ps1 0xF179}
-                "$icon$([Environment]::OSVersion.VersionString) $($PSVersionTable.OS)"
+                "$icon $([Environment]::OSVersion.VersionString) $($PSVersionTable.OS)"
+            }
+            PowerShellCommand {"$(Get-Unicode.ps1 0xE86C) $([Environment]::ProcessPath) $([Environment]::CommandLine)"}
+            PowerShellVersion {"$(Get-Unicode.ps1 0xE86C) PS $($PSVersionTable.PSVersion) $($PSVersionTable.PSEdition)"}
+            Updates
+            {
+                ${UP!} + ' ' + (@(
+                    ((Get-Command choco -ErrorAction Ignore) -and $(choco outdated -r)) ? 'choco' : $null
+                    ((Get-Command winget -ErrorAction Ignore) -and $(winget list --upgrade-available)) ? 'winget' : $null
+                ) |Where-Object {$_}) -join ' '
             }
-            PowerShellCommand {"$(Get-Unicode.ps1 0xE86C)$([Environment]::ProcessPath) $([Environment]::CommandLine)"}
-            PowerShellVersion {"$(Get-Unicode.ps1 0xE86C)PS $($PSVersionTable.PSVersion) $($PSVersionTable.PSEdition)"}
-            Uptime {"${POWER SYMBOL} $(Get-Uptime)"}
-            UserName {"${BUST IN SILHOUETTE}$env:USERNAME"}
+            Uptime {"$POWER$(Get-Uptime)"}
+            UserName {"$USER $env:USERNAME"}
             default {$_}
         }
     }