Execution

Author(s)

• Manuel

Tags

Execution Self-Elevation Stub PowerShell Windows Environment EnvVar PATH PSModulePath

Functions

Add-ToMultiValueEnvVar Clear-TempDirectories ConvertTo-SplatHashtable Exit-AndWaitOnUI Format-SplatHashtable Get-QuotedPath Invoke-NativeCommand Invoke-StubScript Invoke-WhenFileChanged Invoke-WithProgressBoard Invoke-WithSpinner New-ProgressBoard Remove-EnvVar Remove-FromMultiValueEnvVar Remove-ItemSafe Remove-NativeProgressNoise Restart-SelfElevated Set-EnvVar Set-PSScriptID Show-Countdown Write-Change Write-Dim Write-Fail Write-Header Write-Item Write-Ok

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

Execution v5.7.0+sha.39a33b1

## [v5.7.0] - 2026-08-18

### Added

- `Invoke-WithProgressBoard` und `New-ProgressBoard`: ein Progress-Board fuer n
 parallel laufende, benannte Zeilen -- `Invoke-WithSpinner` ist der Fall n=1.
 `Invoke-WithProgressBoard` spannt das Board fuer die Dauer eines
 ScriptBlocks auf, uebergibt es als ersten Parameter, raeumt im `finally`
 auf und reicht die Ausgabe des ScriptBlocks unveraendert durch. Es startet
 selbst keine Worker -- die Nebenlaeufigkeit bleibt beim Aufrufer
 (`ForEach-Object -Parallel`, `Start-ThreadJob`, ein Runspace-Pool oder gar
 keine). Meldungen aus fremden Runspaces laufen ueber eine schlichte
 Hashtable auf einer `ConcurrentQueue`
 (`$board.Queue.Enqueue(@{ Name = ...; State = ...; Detail = ... })`), ohne
 dass der Worker dieses Modul oder einen seiner Typen kennen muss.
 `New-ProgressBoard` erzeugt das Board separat, wenn man nach dem Lauf noch
 an die Zustaende oder die Historie will (Wiederaufsatz ueber `-History`).
- Sieben Zustaende je Zeile: `Waiting`, `Running`, `Succeeded`, `Failed`,
 `Skipped`, `Warned`, `Cancelled`. Erlaubter Pfad ist `Waiting -> Running ->`
 ein Endzustand, ein Endzustand ist endgueltig; jeder andere Uebergang und
 jeder Zustand ausserhalb der sieben ist ein terminierender Fehler statt
 eines still ignorierten Ergebnisses.
- Fuenf Maler, einmal beim Start gewaehlt und danach nicht mehr getestet:
 `Table` (animierte Tabelle, automatische Wahl auf einer faehigen Konsole),
 `Stream` (nur laufende Zeilen im Block, fertige Zeilen scrollen hoch -- nie
 automatisch gewaehlt), `CI` (GitHub-Actions-Log-Gruppen statt Animation,
 automatisch bei gesetztem `GITHUB_ACTIONS`), `Log` (eine schlichte Zeile je
 fertiger Zeile, angehaengt sobald sie fertig ist -- ohne Escape-Sequenz und
 ohne Cursor, also in Datei und Pipe unveraendert lesbar; die automatische
 Wahl ueberall dort, wo Animation unmoeglich ist und `Start-ThreadJob`
 existiert) und `Plain` (kein Terminal, keine Escape-Sequenzen, kein Thread
 -- alle Zeilen erst am Ende; der Fallback ohne `Start-ThreadJob`, der immer
 geht). Ein ausdruecklich angeforderter Maler, den die Konsole nicht traegt,
 degradiert auf `Log`, solange `Start-ThreadJob` da ist, sonst auf `Plain`.
- Die bleibende Zeile traegt den sechsspaltigen Zustands-Tag (`[ ok ]`,
 `[fail]`, `[skip]`, `[warn]`, `[stop]`, ...). Der Glyph des Writers allein
 trennt die sieben Zustaende nicht -- `Warned` teilt sich `Write-Item` mit
 `Running`, `Cancelled` teilt sich `Write-Fail` mit `Failed` --, und bei
 `Table`, `Plain` und dem CI-Rest ist diese Zeile alles, was am Ende stehen
 bleibt. Betrifft auch die Ergebnis-Zeile von `Invoke-WithSpinner`: sie liest
 dieselbe Quelle.
- Die Zustands-Tags sind Woerter statt Glyphen. `Succeeded` und `Failed`
 trugen den Haken bzw. das Kreuz aus `New-GlyphTable`; auf der bleibenden
 Zeile steht der Glyph des Writers ohnehin schon davor, also sagte eine
 fertige Zeile dasselbe zweimal. Damit haengt kein Tag mehr am Glyph-Satz:
 ein gerenderter Rahmen ist unabhaengig davon, was die Konsole zeichnen kann,
 und `Get-ProgressStateTable` nimmt folgerichtig keine Faehigkeit mehr
 entgegen.
- Die Zeilenbreite wird in Anzeigespalten gemessen statt in UTF-16-Einheiten.
 Ein doppelt breites Zeichen (CJK, die meisten Emoji) belegt eine Einheit und
 zwei Spalten; eine Zeile voll davon kam so durch die Deckelung, lief dann
 ueber, brach um und verschob die Cursor-Arithmetik des Blocks. Gemessen wird
 ueber `StringInfo`-Textelemente plus East-Asian-Width, geschnitten wird
 elementweise.
- Die Tag-Spalte der bleibenden Zeile steht bei allen sieben Zustaenden an
 derselben Stelle. `Write-Dim` ist der einzige der vier Board-Writer ohne
 Glyph, also begannen `Waiting` und `Skipped` zwei Spalten weiter links als
 die uebrigen fuenf -- unter `Table`, wo jede Zeile unter der naechsten steht,
 musste der Tag damit gesucht statt gelesen werden. Der Ausgleich sitzt an der
 einen Stelle, die den fehlenden Glyph ohnehin schon feststellt, also erben
 ihn beide bleibenden Pfade.
- Die Abschlusszeile unterscheidet drei Faelle statt zwei. Sie meldete Erfolg,
 sobald nichts fehlgeschlagen war -- auch fuer ein Board, dessen Zeilen nie
 gelaufen waren, und auch fuer einen Lauf, der nur gewarnt hatte. Jetzt:
 Fehlschlag bei `Failed` oder `Cancelled`, weder-noch bei einer Zeile ohne
 Endzustand oder einem `Warned`, Erfolg sonst. `Skipped` bleibt Erfolg --
 uebersprungen ist kein Mangel und der Normalfall jedes Wiederaufsatzes.
- `Get-ConsoleCapability`: viertes, unabhaengiges Flag `Ansi` -- ob die
 Konsole eine Escape-Sequenz ausfuehrt statt sie als Text auszugeben. Treibt
 die Maler-Wahl von `Invoke-WithProgressBoard` (zusammen mit `Animation` und
 `Start-ThreadJob` noetig fuer die animierten Maler), nicht die sechs
 Anzeige-Writer aus v5.6.0.

### Fixed

- `Invoke-WithProgressBoard`: Der Abschluss im `finally` hielt einen Maler, dessen
 Thread nie einen Slot bekommen hat, faelschlich fuer gestoppt. Der Zustandstest
 lautete `-ne 'Running'`, und `NotStarted` ist ungleich `Running` -- der Kanal
 wurde also ein zweites Mal geleert, waehrend der Maler jederzeit anlaufen und
 dasselbe tun konnte. Genau das Rennen, gegen das der uebersprungene Schluss-Drain
 und die Warnung ueberhaupt existieren. Getestet wird jetzt auf die drei
 Endzustaende `Completed`, `Failed`, `Stopped`; jeder andere Zustand zaehlt als
 "laeuft noch".