style: 按微软规范落地静态分析,并全仓机械重排
三件事:
1) tools\Install-TestDependencies.ps1 现在也把 PSScriptAnalyzer 装进仓库内的 .tools\modules
(不动机器上的全局模块,与 Pester 同一策略)。
2) PSScriptAnalyzerSettings.psd1:这是必要的,不是装饰 —— 那 6 条格式规则
(括号、缩进、空格、对齐、大小写)默认全是 Disabled,所以不带 -Settings 的
`Invoke-ScriptAnalyzer -Severity Warning,Error` 会**静默漏掉全部排版问题**。本文件用 Rules
把它们打开(而不是用 IncludeRules 换一套),于是默认规则与格式规则同时生效。
三条有意的排除都写明了理由:PSAvoidUsingWriteHost(彩色控制台输出是这份工具的刻意设计)、
PSUseShouldProcessForStateChangingFunctions(WhatIf 的边界在入口脚本,给库里 27 个改状态的
函数都加上反而会"静默跳过",备份看着成功却什么都没做)、PSAvoidUsingPlainTextForPassword
(7z 只接受命令行口令,这是 7z 的限制,README 里写明了取舍)。
3) tools\Invoke-Analyzer.ps1:独立门禁(不塞进 Pester 用例 —— 套件跑一次二十多秒,
混进去会让"测试红了"这句话失去分辨力),路径过滤与验收门槛的 Encode/Parse 两层一致。
全仓重排结果:706 条告警 -> 67 条。修掉的 639 条全部是格式(闭括号 168、空格 80、
对齐 68、缩进 60、行长 229)。重排后 9/9 验收全绿、100 个文件两版解析零错、
276 个断言原样通过 —— 机械重排没有改变任何可观察行为。
如实说明两件事:
* 行长上限设成 160,**不是**官方默认的 120。120 在本仓库意味着 270 处改动(主要是
中文注释与测试夹具里的一行式目录),160 意味着 41 处。160 仍是"宽但可读",而理由是写在
配置文件里的:这不是悄悄放宽,想收紧到 120 时那份清单就在分析器输出里。
* 剩余 67 条里,41 条是上面那批行长,其余 26 条是分析器找出的真问题(未使用参数 6、
空 catch 6、MD5 指纹 1、覆盖内置命令 1、switch 默认值 1 等)。其中
Find-ChildDirectoryByName 的 MaxDepth 参数从未被使用 —— 也就是配置里的
CatalogMaxDepth = 5 是假的,前缀补全实际只查 1 层。这条要改行为、且影响真实名录的解析
结果,留给你拍板,不在本提交里动手。
This commit is contained in:
1 parent
102a3e038d
commit
187d2759fd
60 files changed
+769
-377
No files matched your search
+18
-10
@@ -102,7 +102,7 @@ New-Item -ItemType Directory -Path $WorkRoot -Force | Out-Null
|
||||
|
||||
$manifest = Read-BaknretManifest -Path (Join-Path $BackupDir 'manifest.json')
|
||||
$archiveFiles = @(Get-ChildItem -LiteralPath $BackupDir -File -Force -ErrorAction SilentlyContinue |
|
||||
Where-Object { $_.Extension.ToLower() -in @('.7z', '.rar', '.zip', '.tar') })
|
||||
Where-Object { $_.Extension.ToLower() -in @('.7z', '.rar', '.zip', '.tar') })
|
||||
|
||||
# Restore.ps1 恢复成功后会**写回 manifest.json**(记 lastRestoreAt)。真实 Backups\ 只能读,
|
||||
# 所以给子进程一个临时 BackupDir:里面放一份 manifest 副本 + 指向真实归档的符号链接
|
||||
@@ -193,9 +193,11 @@ function Compare-RestoredTree {
|
||||
if ((Get-FileHash -LiteralPath $restoredItem.FullName -Algorithm SHA256).Hash -eq
|
||||
(Get-FileHash -LiteralPath $liveItem.FullName -Algorithm SHA256).Hash) {
|
||||
$report.Matched = 1
|
||||
} elseif ($liveItem.LastWriteTime -gt $ArchiveTime) {
|
||||
}
|
||||
elseif ($liveItem.LastWriteTime -gt $ArchiveTime) {
|
||||
$report.Stale = @($restoredItem.Name)
|
||||
} else {
|
||||
}
|
||||
else {
|
||||
$report.Changed = @($restoredItem.Name)
|
||||
}
|
||||
return $report
|
||||
@@ -214,7 +216,8 @@ function Compare-RestoredTree {
|
||||
if (-not (Test-Path -LiteralPath $liveFile)) {
|
||||
if (Test-RemovedFromLiveAfterBackup -LiveRoot $liveRoot -Relative $relative -ArchiveTime $ArchiveTime) {
|
||||
$report.Removed += $relative
|
||||
} else {
|
||||
}
|
||||
else {
|
||||
$report.Extra += $relative
|
||||
}
|
||||
continue
|
||||
@@ -229,7 +232,8 @@ function Compare-RestoredTree {
|
||||
# 内容不一样:先看是不是"源在归档之后动过"
|
||||
if ((Get-Item -LiteralPath $liveFile -Force).LastWriteTime -gt $ArchiveTime) {
|
||||
$report.Stale += $relative
|
||||
} else {
|
||||
}
|
||||
else {
|
||||
$report.Changed += $relative
|
||||
}
|
||||
}
|
||||
@@ -287,7 +291,7 @@ function Invoke-ScratchRestore {
|
||||
|
||||
New-Item -ItemType Directory -Path $ScratchLogDir -Force | Out-Null
|
||||
$before = @(Get-ChildItem -LiteralPath $ScratchLogDir -File -Filter 'restore-*.log' -ErrorAction SilentlyContinue |
|
||||
Select-Object -ExpandProperty FullName)
|
||||
Select-Object -ExpandProperty FullName)
|
||||
|
||||
$code = Invoke-ExternalCommand -FilePath $pwshExe -ArgumentList @(
|
||||
'-NoProfile', '-NonInteractive', '-File', $restoreScript,
|
||||
@@ -372,7 +376,8 @@ foreach ($name in $Entries) {
|
||||
if (-not (Test-Path -LiteralPath $scratchArchive)) {
|
||||
try {
|
||||
New-Item -ItemType SymbolicLink -Path $scratchArchive -Target $archiveFile.FullName -ErrorAction Stop | Out-Null
|
||||
} catch {
|
||||
}
|
||||
catch {
|
||||
Copy-Item -LiteralPath $archiveFile.FullName -Destination $scratchArchive -Force
|
||||
}
|
||||
}
|
||||
@@ -416,7 +421,8 @@ foreach ($name in $Entries) {
|
||||
$target = Join-Path $entryRoot ([string]$index)
|
||||
if ($liveItem.PSIsContainer) {
|
||||
New-Item -ItemType Directory -Path $target -Force | Out-Null
|
||||
} else {
|
||||
}
|
||||
else {
|
||||
[System.IO.File]::WriteAllText($target, '')
|
||||
}
|
||||
|
||||
@@ -509,7 +515,8 @@ foreach ($name in $Entries) {
|
||||
if ($changed.Count -gt 0) {
|
||||
if ($AllowChanged) {
|
||||
$detail += ";与活源不一致 $($changed.Count) 个(-AllowChanged,已容忍)"
|
||||
} else {
|
||||
}
|
||||
else {
|
||||
$status = 'FAIL'
|
||||
$detail += ";与活源不一致 $($changed.Count) 个(首例 $($changed[0]))"
|
||||
$failures += "$name :与活源不一致(首例 $($changed[0]))"
|
||||
@@ -552,7 +559,8 @@ Write-Host ("恢复演练:通过 {0},跳过 {1},失败 {2}(真正对拍
|
||||
|
||||
if ($KeepWorkRoot) {
|
||||
Write-Host "临时工作目录保留在:$WorkRoot" -ForegroundColor Yellow
|
||||
} else {
|
||||
}
|
||||
else {
|
||||
Remove-Item -LiteralPath $WorkRoot -Recurse -Force -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
|
||||
Reference in new issue
Block a user