頼る部品は、コマンドの側に書いておく——QDが、コマンドごとに使う部品を宣言させ、毎晩それだけを読んで1本ずつ別に動かす理由
▶ YouTube で見る(音つき・30秒)
「自分のパソコンでは動くのに、渡した先では動かない」。社内のマクロやツールでよく聞く話です。火曜日は、QDの設計の考え方の回です。今回は、コマンドが頼っている部品を、コマンドの側に書いておくという決まりについて書きます。地味な決まりですが、必要なコマンドだけを配る、直した所が別の所を壊さない、という2つを支えています。
全部を読み込めば動く、が困るのは配る日
社内で育ったツールは、たいてい全部入りで動いています。共通の計算をまとめたファイル、画面の部品、設定。作った人の手元では、それが全部そろった状態で使われます。
困るのは、一部だけを別の人に渡す日です。「この確認だけ使いたい」と言われて、そのファイルを渡す。ところが、それが頼っている共通の計算が抜けていて、相手の手元で初めて止まります。
どのファイルが要るかは、作った人の頭の中にしかありません。作った人が異動したり、時間が経ったりすると、全部入りのまま渡すしかなくなります。要る物が分からないツールは、まとめてしか動かせません。
設計の確認は、部署や取引先ごとに要る物が違います。全部入りでしか渡せないと、使わない機能まで入れて、そのぶん説明と確認が増えます。
頼っている部品が見えないと、何が起きるか
見えない頼り方にはもう1つあります。あるコマンドが、自分では読み込んでいない計算を、別のコマンドが先に読み込んでくれていたおかげで使えている、という状態です。
全部入りで動かしている間は、これに誰も気づきません。読み込む順番が変わった日や、片方のコマンドを外した日に、関係のないはずのコマンドが止まります。
前回の月曜日の回で書いた「直していない所が壊れる」理由の1つ、見えないつながりがこれです。気をつけて書けば防げる、という種類の話ではなく、数が増えるほど必ず出てきます。
ですから、頼っている部品は、人の記憶ではなく、ファイルに書いておく。そして書いた通りで本当に足りているかを、機械に確かめさせる。この2つをQDの決まりにしました。
// 単体:一覧に書いたものだけを読む
if (isolated) { (C.deps || []).forEach(req); return; }
// …検証ケースを流す…
// 単体の結果が、全部を読んだときの結果と同じなら独立している
const iso = { pass: R.pass, n: R.n, deps: R.deps,
same: !!prev && noTime(prev) === noTime(R) && prev.caseHash === R.caseHash };
console.log((iso.same ? 'OK ' : 'NG ') + cmd + ' 単体(deps ' + R.deps.length + ' 本だけ)で ' + R.pass + '/' + R.n);QDの答え:頼る部品は、コマンドごとに書いておく
QDは1つのファイルに1つのコマンドで作っています。そのうえで、コマンドごとに、動くのに要る部品の一覧を書いておきます。
たとえば今朝下がった抜き勾配のチェックなら、一覧は5つです。形の共通の計算、曲線の書き出し、勾配の計算、金型の作業台で共通に使う計算、そしてコマンド本体です。これ以外は読みません。
別の作業台の共通の計算を借りるときは、コマンドのファイルの頭に、借りる先を書きます。配る物をまとめるときは、この書き置きを見て、借りた先のファイルも一緒に入れます。今は436本のコマンドが、この書き置きを持っています。
ファイルが無いコマンドは、QDに存在しない、というのが元からの決まりです。頼る部品が書いてあれば、要るコマンドだけを選んで、要るファイルだけを入れた配布物を作れます。
頼る部品は、人の記憶ではなくファイルに書く。
書いた通りで足りているかは、毎晩機械が確かめる。
毎晩、書いた部品だけで、1本ずつ別に動かす
書いておくだけでは、書き漏れがあっても分かりません。そこで毎晩の検査で、検証ケースを持つ422本のコマンドを、1本ずつ別々に起動し、一覧に書いた部品だけを読ませて動かしています。
その結果を、全部を読み込んで動かしたときの結果と比べます。同じ答えが出れば、一覧に書いた部品だけで足りている、つまり見えない頼り方をしていない、と言えます。違えば、どこかで書いていない部品に頼っています。
今朝は422本すべてが、全部を読んだときと同じ答えを返しました。一覧に書いた部品の数は4つが136本でいちばん多く、3〜5つのコマンドが315本です。いちばん多いものでも15です。
1本ずつ別に起動するので、全部を一度に動かすより時間はかかります。それでも毎晩流しているのは、書き漏れが入った夜に、その夜のうちに名前が分かるようにするためです。
今朝の数字:498本、下がった1本も単体では同じ答え
今朝11月10日の夜間の検査は、午前2時に始まって4時3分に終わりました。498のコマンドのうち、実用が69、簡易が308、試作が103、未実装が18です。
下がったのは1本で、抜き勾配のチェックが実用から簡易に下がりました。代表の検証ケース22件は全部通りましたが、形を変えて自動で作った試験152件のうち2件が通りませんでした。検査は失敗として終わり、名前が記録に残っています。
このチェックも、一覧に書いた5つの部品だけで動かしたときは、全部を読んだときと同じ答えでした。今回の下がり方は、見えない頼り方が原因ではないということです。何が答えを揺らしたかは、この記事を書いている時点ではまだ調べている途中です。
前の晩に下がった位置合わせのコマンドは、今朝は形を変えた試験136件をすべて通り、実用に戻りました。1本戻って1本下がったので、実用の数は前の晩と同じ69です。
import shutil, subprocess, tempfile, pathlib
def needs_of(tool):
"""ファイルの頭の『# needs: a.py, b.py』を読む"""
for line in pathlib.Path(tool).read_text(encoding="utf-8").splitlines()[:10]:
if line.startswith("# needs:"):
return [x.strip() for x in line[8:].split(",") if x.strip()]
return []
def run(folder, tool, sample):
r = subprocess.run(["python", tool, sample], cwd=folder, capture_output=True, text=True)
return r.returncode, r.stdout
def check(src, tool, sample):
full = run(src, tool, sample) # 全部入りのフォルダで動かす
with tempfile.TemporaryDirectory() as tmp: # 空のフォルダに、書いた物だけ写す
for f in [tool, sample] + needs_of(pathlib.Path(src, tool)):
shutil.copy(pathlib.Path(src, f), tmp)
alone = run(tmp, tool, sample)
return "OK 書いた部品で足りている" if alone == full else "NG 書いていない物に頼っている"
print(check("tools", "bom_check.py", "sample.csv"))社内のツールで、今日から始められること
QDのような仕組みがなくても、始められることがあります。まず、マクロやツールのファイルの頭に、そのファイルが使う共通のモジュールや設定ファイルの名前を書いておきます。使う人にも、次に直す人にも読める場所です。
次に、ふだん使っていないパソコンや、まっさらな作業用のフォルダに、そのファイルと、頭に書いた物だけを置いて動かしてみます。止まれば、書いていない物に頼っています。全部のツールで一度ずつやるだけでも、渡した先で止まる回数は減ります。
最後に、それを直すたびに繰り返します。手で続かなければ、画面を開かずにフォルダごと流す回や、毎晩すべてを測り直す回に書いたように、決まった時刻に機械に流させます。
社内のマクロが全部入りでしか動かず、部署ごとに配り分けられなくて困っている、という相談もお受けしています。今のツール一式をお借りして、どの機能が何に頼っているかを書き出すところから始めます。ヒアリングと自働化設計書のご提案までは無料です。QDで確かめられることの全体は、製品ページQRONIX QDにまとめています。
記事一覧をすべて見る →