refactor: Common.psm1 拆成 BakNRet/{Public,Private},一函数一文件 + 薄加载器
3152 行、66 个函数的单文件模块拆成: BakNRet\BakNRet.psd1 模块清单:FunctionsToExport 是显式白名单(62 个名字) BakNRet\BakNRet.psm1 加载器:点源顺序的唯一一处声明 BakNRet\Public\*.ps1 62 个对外函数,一函数一文件,文件名 = 函数名 BakNRet\Private\*.ps1 4 个内部函数 + State.ps1(模块级状态集中一处) 为什么是一函数一文件:这是社区里脚本模块的主流形态(调研实测:winutil 79 个、 Terminal-Icons 24 个、ModuleBuilder 23 个,全部如此)。收益是改动落在小文件里、diff 按职责 可读、模块级状态有唯一去处。 为什么这不算"打散":模块内 dot-source 的文件共享同一个模块作用域(实测确认),所以 "按顺序点源 67 个文件"与"点源一个大文件"在语义上等价;顺序只在加载器里出现一次, tools\Build-BakNRetModule.ps1 从那里读出顺序就能拼回单文件 —— 本次产物 dist\BakNRet.psm1 3240 行、两个版本都解析零错。 新增一条断言把这条承诺钉住:加载器点源的文件集合必须与磁盘一致、导出名单必须与 Public\ 一一对应。漏一个文件或漏一个名字就是静默少一个函数 —— 而那种错在运行时只表现为 "找不到命令"。 引用更新:11 个文件里的 Common.psm1 改成 BakNRet\BakNRet.psd1(走清单导入, FunctionsToExport 才真的说了算);Common.psm1 直接删除,不留转发垫片。 验收:test.ps1 9/9 全绿(7 与 5.1),98 个文件两版解析零错,276 个断言原样通过 —— 这次搬家没有改变任何可观察行为。
This commit is contained in:
1 parent
78f43c8cc9
commit
2ad7987ffe
83 files changed
+3547
-3310
No files matched your search
+2
-2
@@ -74,7 +74,7 @@ if ($DryRun) { $WhatIfPreference = $true }
|
||||
# 载入依赖
|
||||
# ============================================================================
|
||||
|
||||
$modulePath = Join-Path $PSScriptRoot 'Common.psm1'
|
||||
$modulePath = Join-Path $PSScriptRoot 'BakNRet\BakNRet.psd1'
|
||||
if (-not (Test-Path -LiteralPath $modulePath)) {
|
||||
Write-Error "找不到依赖模块:$modulePath,请确保所有文件在同一目录。"
|
||||
exit 1
|
||||
@@ -109,7 +109,7 @@ if ($WhatIfPreference) { Write-Log '试运行模式(-WhatIf / -DryRun):不
|
||||
if (-not (Test-Administrator)) {
|
||||
Write-Log '建议以管理员身份运行以获取完整的目录访问权限' -Level WARN
|
||||
}
|
||||
# 同一份备份目录同一时间只允许一个进程操作(见 Common.psm1 的「运行锁」一节)。
|
||||
# 同一份备份目录同一时间只允许一个进程操作(见 BakNRet 模块的「运行锁」一节)。
|
||||
# 三种只读模式不取锁:它们一个字节都不写,没必要被正在跑的备份挡在外面。
|
||||
$runLock = $null
|
||||
if (-not $WhatIfPreference -and -not $VerifyOnly) {
|
||||
|
||||
Reference in new issue
Block a user