PowerShell の -match ‘(?m)^KEY\s*=\s*250\s*$’ が設定ファイルの値を見落とす。原因は行末のコメント(#)

設定ファイルの値を PowerShell の -match '(?m)^PATTERN_MAX\s*=\s*250\s*$' で検査していたら、値は 250 なのに「250 ではありません」で止まりました。
原因は、その行の末尾に付いていた # 128→250(…) というコメントです。\s*$ はコメントの文字を飲めないので、行末まで届かずに照合が外れます。
(#.*)? を足して「行末にコメントがあってもよい」形にしたら通りました。

症状

配置の前に、Python の設定値が期待どおりか PowerShell で確かめるスクリプトを書いていました。検査の行はこうです。

function Need([bool]$ok, [string]$msg) { if (-not $ok) { throw $msg } }

Need ((Get-Content -LiteralPath $gate -Raw) -match '(?m)^PATTERN_MAX\s*=\s*250\s*$') 'release_gate の PATTERN_MAX が 250 ではありません'

これを流すと、ここで止まります。

Exception: ...deploy.ps1:131
Line |
 131 |  function Need([bool]$ok, [string]$msg) { if (-not $ok) { throw $msg } }
     |                                                           ~~~~~~~~~~
     | release_gate の PATTERN_MAX が 250 ではありません

ところが grep で中身を見ると、値はちゃんと 250 になっていました。

tools/staging/release_gate.py:40:PATTERN_MAX = 250   # 128→250(上限の引き上げ)

環境

  • Windows 11
  • PowerShell 7(#Requires -Version 7.2 のスクリプト)
  • 検査される側は Python のスクリプト(NAME = 値 の形の定数)

原因

正規表現が「行の頭から行の終わりまで、PATTERN_MAX = 250 と空白しか無い」ことを求めていたからです。

部分 意味
(?m) ^ と $ を、文字列全体ではなく各行の頭と終わりに合わせる
^PATTERN_MAX\s*=\s*250 行の頭から PATTERN_MAX = 250
\s*$ その後は空白だけで、すぐ行の終わり

実際の行は 250 の後ろに空白と # 128→250(…) が続きます。\s* は空白は飲めても # 以降は飲めないので、$ に届かず不一致になります。

値を引き上げたときに「なぜ変えたか」をコメントで残したのが、そのまま検査に引っかかった形です。すぐ上の行にある同じ作りの CATALOG_MAX_ENTRIES の検査は、相手の行にコメントが無かったので通っていました。

解決手順

  1. 行末の \s*$ の前に、「# から行末まで」を任意で足します。

“`powershell
# 直す前
-match ‘(?m)^PATTERN_MAX\s=\s250\s*$’

# 直した後
-match ‘(?m)^PATTERN_MAX\s=\s250\s(#.)?$’
“`

  1. 同じ型の検査がほかにもあれば、まとめて直します。今回は 2 か所でした。

powershell
Need ((Get-Content -LiteralPath $analyzer -Raw) -match '(?m)^CATALOG_MAX_ENTRIES\s*=\s*250\s*(#.*)?$') '分析器の CATALOG_MAX_ENTRIES が 250 ではありません'
Need ((Get-Content -LiteralPath $gate -Raw) -match '(?m)^PATTERN_MAX\s*=\s*250\s*(#.*)?$') 'release_gate の PATTERN_MAX が 250 ではありません'

  1. 書き換えた .ps1 に構文エラーが無いか確かめてから流し直します。

powershell
$tk = $null; $e = $null
$null = [System.Management.Automation.Language.Parser]::ParseFile('C:\path\to\deploy.ps1', [ref]$tk, [ref]$e)
"parseErrors=$($e.Count)"

流し直したら、この検査は OK になって次の検査へ進みました。

(#.*)? を足しても、PATTERN_MAX = 2500 や PATTERN_MAX = 250x のような値違いは今までどおり外れます。250 の直後は「空白」か「#」か「行末」しか許していないからです。

再発防止・気づき

  • 行まるごとを ^...$ で照合する検査は、コメントや末尾の空白など「値以外のもの」が行に入った時点で落ちます。設定値を見る検査を書くときは、最初から (#.*)? を入れておくと安全です。
  • 今回は本番ではなく、本番の写しで配置スクリプトを最後まで通す予行で見つかりました。予行を飛ばしていたら本番の配置の途中で止まっていたので、写しでの通し実行はやっておく価値がありました。
  • 直すときは元のスクリプトを上書きせず、版を上げた別ファイルにして、変えた行だけを Compare-Object で確かめました。

関連

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方