PrincessPi/general-scripts-and-system-ssssssetup
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

waypoit debuguing

Browse Source
This commit is contained in:
Princess Pi
2026-09-25 16:19:14 -06:00
parent 608e225833
commit 07a29167dd
1 changed files with 148 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Windows-Scripts/checksum.ps1
+148 -48
View File
@@ -5,15 +5,15 @@ param(
[Parameter(Position = 0, ParameterSetName = 'Match', ValueFromPipeline = $true)] [Parameter(Position = 0, ParameterSetName = 'Match', ValueFromPipeline = $true)]
[string[]]$FilePath, [string[]]$FilePath,
# Custom output file (-f / -OutFile) # Custom output file (-f / -OutFile / -of)
[Parameter(Mandatory = $false, ParameterSetName = 'Generate')] [Parameter(Mandatory = $false, ParameterSetName = 'Generate')]
[Alias('f')] [Alias('f', 'of', 'OF')]
[string]$OutFile, [string]$OutFile,
# Auto output file switch (-o) # Auto output file switch (-s / -Save)
[Parameter(Mandatory = $false, ParameterSetName = 'Generate')] [Parameter(Mandatory = $false, ParameterSetName = 'Generate')]
[Alias('o')] [Alias('s', 'S')]
[switch]$AutoOut, [switch]$Save,
# File containing checksums to verify (-c / -Check) # File containing checksums to verify (-c / -Check)
[Parameter(Mandatory = $false, ParameterSetName = 'Verify')] [Parameter(Mandatory = $false, ParameterSetName = 'Verify')]
@@ -36,6 +36,11 @@ param(
[Alias('r')] [Alias('r')]
[switch]$Recursive, [switch]$Recursive,
# Princess Pi art flag (-pp / -PrincessPi)
[Parameter(Mandatory = $false)]
[Alias('pp')]
[switch]$PrincessPi,
# Help flag (-h / -Help) # Help flag (-h / -Help)
[Parameter(Mandatory = $false)] [Parameter(Mandatory = $false)]
[Alias('h')] [Alias('h')]
@@ -49,9 +54,10 @@ NAME
checksum - Compute and verify message digests / file checksums checksum - Compute and verify message digests / file checksums
SYNOPSIS SYNOPSIS
.\checksum.ps1 [-FilePath] <string[]> [-o] [-f <string>] [-Algorithm <string>] [-r] .\checksum.ps1 [-FilePath] <string[]> [-s] [-f <string>] [-Algorithm <string>] [-r]
.\checksum.ps1 [-FilePath] <string[]> -Match <string> [-Algorithm <string>] [-r] .\checksum.ps1 [-FilePath] <string[]> -Match <string> [-Algorithm <string>] [-r]
.\checksum.ps1 -Check <string> [-Algorithm <string>] [-r] .\checksum.ps1 -Check <string> [-Algorithm <string>] [-r]
.\checksum.ps1 -PrincessPi
.\checksum.ps1 -Help .\checksum.ps1 -Help
DESCRIPTION DESCRIPTION
@@ -63,15 +69,15 @@ PARAMETERS
-FilePath <string[]> -FilePath <string[]>
Specifies the target file(s) or wildcard pattern (*). Specifies the target file(s) or wildcard pattern (*).
-o, -O -s, -S, -Save
Auto-saves checksum results. (Takes no arguments). Auto-saves checksum results. (Takes no arguments).
- If input filename contains a wildcard (*), saves to 'checksums.<algo>'. - If input filename contains a wildcard (*), saves to 'checksums.<algo>'.
- If input filename does NOT contain a wildcard, saves to '<filename>.<algo>'. - If input filename does NOT contain a wildcard, saves to '<filename>.<algo>'.
When combined with -r and *, recursively auto-generates checksums per directory. When combined with -r and *, recursively auto-generates checksums per directory.
-f, -F, -OutFile <string> -f, -F, -OutFile, -of, -OF <string>
Saves checksum results to a specific custom filename. Saves checksum results to a specific custom filename.
Overrides the auto-naming behavior of -o if both are passed. Overrides the auto-naming behavior of -s if both are passed.
-c, -C, -Check <string> -c, -C, -Check <string>
Reads hashes from a specified checksum file and verifies target files on disk. Reads hashes from a specified checksum file and verifies target files on disk.
@@ -88,15 +94,18 @@ PARAMETERS
-r, -R, -Recursive <switch> -r, -R, -Recursive <switch>
Processes target files or verification files recursively across directory structures. Processes target files or verification files recursively across directory structures.
-pp, -PrincessPi <switch>
Displays Princess Pi ASCII art in magenta.
-h, -H, -Help <switch> -h, -H, -Help <switch>
Displays this help documentation. Displays this help documentation.
EXAMPLES EXAMPLES
1. Compute SHA256 for a single file and auto-save as 'myfile.iso.sha256': 1. Compute SHA256 for a single file and auto-save as 'myfile.iso.sha256':
.\checksum.ps1 myfile.iso -o .\checksum.ps1 myfile.iso -s
2. Compute SHA512 recursively and auto-save as 'checksums.sha512' in each folder: 2. Compute SHA512 recursively and auto-save as 'checksums.sha512' in each folder:
.\checksum.ps1 * -r -o -a SHA512 .\checksum.ps1 * -r -s -a SHA512
3. Compute SHA256 checksums and save to a specific custom file: 3. Compute SHA256 checksums and save to a specific custom file:
.\checksum.ps1 * -f my_hashes.txt .\checksum.ps1 * -f my_hashes.txt
@@ -109,6 +118,70 @@ EXAMPLES
'@ '@
}; };
function Write-ErrorWithHelp {
param([string]$ErrorMessage);
Write-Error $ErrorMessage;
Write-Host "";
Show-Help;
};
function Show-PrincessPiArt {
$art = @'
.. .....
....------..
..:--------.. .......
..----------.. ....---..
...---------=------::....:----:..
..-----=+**************=-----:...
.----+****************=-----...
.--=****************=-----=**+:::--:....
.-#*********##**++=---====++**+-----:.
..:==********#=.+@%-==++===++===++*=----...
.:=::******%%+-::=++====+==++====+**=--...
.+..+*****--@===-:-%--====-=+====+*#=:..
.-.-****#=.#+===--=+===----======+*+..
.::=:+****#@#+=====-**-----*+====++**:.
.. .=****=--======-..%-----%+==++***+-..
..=++***+-.----======..*-----#+==+***#%#+..
.. .:-..---=====--------=-+==+**-@*. ............::::::....
..=:..--===+-:-------*%+==*+#%**=. .....:-------------------------:.
..............-:..--===+-..:-------+==+==.:... ...:----------------------------::.
......:----------::=:...--==+--:.:-------+==+=:.... ....--------------------------:.....
..:::----------------=-::.:--===---:.:------=--:.... ...:---------------------------...
..:------------------=--:..:--=+=--------::.:+-..... ...------------------------------..
...:-----------------:....----==-------:...=%*.......:::--------------------------------:..
...--------------:+......---------------:+%%#.----------------------------:.......-----:..
.:----===-------:-.. .:--------------*%%%%=--------------========------:.......-------:...
..-:.:------------....-.=---------=#%%%%##%------------=-----------------------------------..
.:--:....:--------:##*=:.-------=#%%%%%%#%+-----------=-------------------------------------:
..:-----------------::*%%#-------=###%%%%##=--------------------------------------:............
..:-------------------:.-#%%##+==+%%%%%%#%+------------------------...:::--------------::::::..
...:----------------------..-#%#%%%%%%%%*+#%=-------------------------=-:....:----------------:...
--------------------------:.-#%%%%%%%%+#@%%%--------------------------=++=-::---------------:...
---------------------------...+%%%%%]%%%%#---------------------------------------------:....
............------.....----:....-#%%%%%%%*=------------------------------::+=---------.......
..:-... ....-----.. ....-=-------------------------------------.=*+=.......
..---:....:-----:.......:--------------------------:-------------==+=-......
.:-------------..........:---------------------------..:-------------==..........
..-------------:... ...--------:...----------------....:-----------==-...........
..:----==------:..-.... ..--------:...:---------------.....:----------=+-.....
..------==+=++==-..+--:. .:--------.....-----------=*%=.. ..----------=+=......
....------------........:... ..:--------.....-------+#%%#@%.. ...----------=+=......
..---------===:............... .:----=+*#=. ..--+#**+%@@@#%+. ..:-:..=----=*=:.....
:............:=::+=:--:=.=-.::=... ..*@*-+%@@@:.....-@@#%@*#@@@#%:.. ..-:..---:-#**+-.........
.. ...::::....::-.:.::-.. ..*%:..*@@@*.. ..-%#%@@+%@@@@=.. ...::.=#=..-%*++=:... ...
...... .......... ..**...*#=*%:. .--*#@%+#%@@@@+... ..*%@%+...+%+=*+=-...
..*#:.-#+..+-. .--*#**%%*%@@%=.. ..-%@@*:..+@%=:+**+=:..
..*@#*%%=..==. .-*%@#%@##@@@#-. ...#@@%*-=%@@#:..-=++=-
.:#@*-:++..==. .=#%@%*@@*%*=+*:....:.+@*::+%@@@%=......-*
.-%+...=%##%-. .+@*@%*%@##*-:*+..:-==*@=..:#@+:=*:.......
.:*#:..:*@@@%:. .--%@*%@#*%*#=..-%-....:+#=-.:#%-.:+-.......
.+@#=.-*@@@@*.. ....-%@@@@@@=..+%*.. .--%--=+#%-.:*-. ....
.-=++++++++=... .:***+++==::::... .-%#=-*#%#**#-.
'@
Write-Host $art -ForegroundColor Magenta;
};
function Get-AlgorithmFromHashLength { function Get-AlgorithmFromHashLength {
param([string]$HashString); param([string]$HashString);
@@ -119,7 +192,7 @@ EXAMPLES
96 { return 'SHA384'; } 96 { return 'SHA384'; }
128 { return 'SHA512'; } 128 { return 'SHA512'; }
default { default {
Write-Error "checksum: Could not auto-detect algorithm for hash length $($HashString.Length). Please specify -Algorithm."; Write-ErrorWithHelp "checksum: Could not auto-detect algorithm for hash length $($HashString.Length). Please specify -Algorithm.";
return $null; return $null;
} }
}; };
@@ -142,6 +215,11 @@ process {
return; return;
}; };
if ($PrincessPi.IsPresent) {
Show-PrincessPiArt;
return;
};
if (-not [string]::IsNullOrWhiteSpace($Algorithm)) { if (-not [string]::IsNullOrWhiteSpace($Algorithm)) {
$Algorithm = $Algorithm.ToUpper(); $Algorithm = $Algorithm.ToUpper();
}; };
@@ -149,7 +227,7 @@ process {
# --- ITEM GATHERING (Generate & Match Modes) --- # --- ITEM GATHERING (Generate & Match Modes) ---
if ($PSCmdlet.ParameterSetName -in @('Generate', 'Match')) { if ($PSCmdlet.ParameterSetName -in @('Generate', 'Match')) {
if (-not $FilePath -or $FilePath.Count -eq 0) { if (-not $FilePath -or $FilePath.Count -eq 0) {
Write-Error "checksum: Missing file path parameter. Use -Help for usage."; Write-ErrorWithHelp "checksum: Missing file path parameter. Use -Help for usage.";
return; return;
}; };
@@ -173,7 +251,7 @@ process {
}; };
if (-not $resolvedItems) { if (-not $resolvedItems) {
Write-Error "checksum: $($pathEntry): No such file or directory"; Write-ErrorWithHelp "checksum: $($pathEntry): No such file or directory";
continue; continue;
}; };
@@ -204,17 +282,26 @@ process {
$expectedHash = $Match.Trim().ToLower(); $expectedHash = $Match.Trim().ToLower();
foreach ($item in ($allItems)) { $allItems | ForEach-Object -Parallel {
$actualHash = (Get-FileHash -Path ($item.FullName) -Algorithm ($Algorithm)).Hash.ToLower(); $item = $_
$algo = $using:Algorithm
$exp = $using:expectedHash
$actualHash = (Get-FileHash -Path ($item.FullName) -Algorithm ($algo)).Hash.ToLower();
$targetFile = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue'; $targetFile = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue';
if (-not $targetFile) { $targetFile = $item.Name; }; if (-not $targetFile) { $targetFile = $item.Name; };
if ($targetFile.StartsWith(".\") -or $targetFile.StartsWith("./")) { $targetFile = $targetFile.Substring(2); }; if ($targetFile.StartsWith(".\") -or $targetFile.StartsWith("./")) { $targetFile = $targetFile.Substring(2); };
if ($actualHash -eq $expectedHash) { [PSCustomObject]@{
Write-Host "${targetFile}: " -NoNewline; TargetFile = $targetFile
IsMatch = ($actualHash -eq $exp)
}
} -ThrottleLimit 16 | ForEach-Object {
if ($_.IsMatch) {
Write-Host "$($_.TargetFile): " -NoNewline;
Write-Host "OK" -ForegroundColor Green; Write-Host "OK" -ForegroundColor Green;
} else { } else {
Write-Host "${targetFile}: " -NoNewline; Write-Host "$($_.TargetFile): " -NoNewline;
Write-Host "FAILED" -ForegroundColor Red; Write-Host "FAILED" -ForegroundColor Red;
}; };
}; };
@@ -232,7 +319,7 @@ process {
}; };
if (-not $checkFiles -or $checkFiles.Count -eq 0) { if (-not $checkFiles -or $checkFiles.Count -eq 0) {
Write-Error "checksum: $($Check): No such file or directory"; Write-ErrorWithHelp "checksum: $($Check): No such file or directory";
return; return;
}; };
@@ -309,7 +396,7 @@ process {
}; };
$wantCustomOut = $PSBoundParameters.ContainsKey('OutFile'); $wantCustomOut = $PSBoundParameters.ContainsKey('OutFile');
$wantAutoOut = $AutoOut.IsPresent; $wantAutoOut = $Save.IsPresent;
if ($wantCustomOut -or $wantAutoOut) { if ($wantCustomOut -or $wantAutoOut) {
# Recursive wildcard auto-saves per directory # Recursive wildcard auto-saves per directory
@@ -326,15 +413,16 @@ process {
$currentOutFile = Join-Path -Path ($dirPath) -ChildPath "checksums.$($Algorithm.ToLower())"; $currentOutFile = Join-Path -Path ($dirPath) -ChildPath "checksums.$($Algorithm.ToLower())";
}; };
$linesToWrite = @(); $linesToWrite = $filesInDir | ForEach-Object -Parallel {
foreach ($item in ($filesInDir)) { $item = $_
$hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($Algorithm)).Hash.ToLower(); $algo = $using:Algorithm
$relativePath = $item.Name; $hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($algo)).Hash.ToLower();
"${hash} $($item.Name)"
$outputLine = "${hash} ${relativePath}"; } -ThrottleLimit 16;
$linesToWrite += $outputLine;
foreach ($outputLine in $linesToWrite) {
Write-Output $outputLine; Write-Output $outputLine;
}; }
Set-Content -Path ($currentOutFile) -Value $linesToWrite -Encoding utf8; Set-Content -Path ($currentOutFile) -Value $linesToWrite -Encoding utf8;
}; };
@@ -348,27 +436,31 @@ process {
$singleOutFile = "checksums.$($Algorithm.ToLower())"; $singleOutFile = "checksums.$($Algorithm.ToLower())";
}; };
$linesToWrite = @(); $linesToWrite = $allItems | ForEach-Object -Parallel {
foreach ($item in ($allItems)) { $item = $_
$hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($Algorithm)).Hash.ToLower(); $algo = $using:Algorithm
$hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($algo)).Hash.ToLower();
$relativePath = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue'; $relativePath = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue';
if (-not $relativePath) { $relativePath = $item.Name; }; if (-not $relativePath) { $relativePath = $item.Name; };
if ($relativePath.StartsWith(".\") -or $relativePath.StartsWith("./")) { if ($relativePath.StartsWith(".\") -or $relativePath.StartsWith("./")) {
$relativePath = $relativePath.Substring(2); $relativePath = $relativePath.Substring(2);
}; };
"${hash} ${relativePath}"
} -ThrottleLimit 16;
$outputLine = "${hash} ${relativePath}"; foreach ($outputLine in $linesToWrite) {
$linesToWrite += $outputLine;
Write-Output $outputLine; Write-Output $outputLine;
}; }
Set-Content -Path ($singleOutFile) -Value $linesToWrite -Encoding utf8; Set-Content -Path ($singleOutFile) -Value $linesToWrite -Encoding utf8;
} }
# Auto file for explicit individual files (No wildcard) # Auto file for explicit individual files (No wildcard)
else { else {
foreach ($item in ($allItems)) { $results = $allItems | ForEach-Object -Parallel {
$hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($Algorithm)).Hash.ToLower(); $item = $_
$algo = $using:Algorithm
$hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($algo)).Hash.ToLower();
$relativePath = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue'; $relativePath = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue';
if (-not $relativePath) { $relativePath = $item.Name; }; if (-not $relativePath) { $relativePath = $item.Name; };
@@ -376,20 +468,25 @@ process {
$relativePath = $relativePath.Substring(2); $relativePath = $relativePath.Substring(2);
}; };
$outputLine = "${hash} ${relativePath}"; [PSCustomObject]@{
Write-Output $outputLine; OutputLine = "${hash} ${relativePath}"
ItemOutFile = "$($item.FullName).$($algo.ToLower())"
# Save directly next to the original file: <filename>.<algo> }
$itemOutFile = "$($item.FullName).$($Algorithm.ToLower())"; } -ThrottleLimit 16;
Set-Content -Path ($itemOutFile) -Value $outputLine -Encoding utf8;
}; foreach ($res in $results) {
Write-Output $res.OutputLine;
Set-Content -Path ($res.ItemOutFile) -Value $res.OutputLine -Encoding utf8;
}
}; };
}; };
} }
# Standard console output (No save flags passed) # Standard console output (No save flags passed)
else { else {
foreach ($item in ($allItems)) { $linesToWrite = $allItems | ForEach-Object -Parallel {
$hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($Algorithm)).Hash.ToLower(); $item = $_
$algo = $using:Algorithm
$hash = (Get-FileHash -Path ($item.FullName) -Algorithm ($algo)).Hash.ToLower();
$relativePath = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue'; $relativePath = Resolve-Path -Path ($item.FullName) -Relative -ErrorAction 'SilentlyContinue';
if (-not $relativePath) { $relativePath = $item.Name; }; if (-not $relativePath) { $relativePath = $item.Name; };
@@ -397,9 +494,12 @@ process {
$relativePath = $relativePath.Substring(2); $relativePath = $relativePath.Substring(2);
}; };
$outputLine = "${hash} ${relativePath}"; "${hash} ${relativePath}"
} -ThrottleLimit 16;
foreach ($outputLine in $linesToWrite) {
Write-Output $outputLine; Write-Output $outputLine;
}; }
}; };
} }
} }