0
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

PythonでBOM比較ツールを作ってGitHubで公開した話【DigiKey/Mouser API連携・廃品検出まで】

0
Posted at

はじめに

電子機器の開発・製造に関わる現場では、BOM(Bill of Materials:部品表)の管理が欠かせません。設計変更のたびに「前回との差分はどこ?」「この部品、まだ入手できる?」を手作業で確認するのは時間がかかり、ミスも起きやすいです。

そこで、PythonでBOM比較ツールを自作してGitHubで公開しました。

本記事では、ツールの概要・使い方・実装のポイントをハンズオン形式で紹介します。


ツールでできること

機能 概要
BOM差分比較 追加・削除・Quantity変更・Manufacturer変更を自動検出
廃品・NRND検出 DigiKey / Mouser APIと連携してライフサイクルを確認
代替品表示 廃品部品の代替候補を一覧表示
Excelレポート出力 差分・ライフサイクル結果をシート別に出力
カラム名カスタマイズ 現場ごとに異なるBOMのカラム名に対応
Prepareツール 任意のExcelから必要な列だけ残して保存

動作イメージ(テキストUI):

┌─────────────────────────────────────────────────────────┐
│  ⬡  BOM Diff Tool                   v1.0.0 + DigiKey  │
├──────────────┬──────────────────────────────────────────┤
│ OLD BOM FILE │  +Added │ -Removed │ △Qty │ △Mfr      │
│ [old.xlsx ]… │  ─────────────────────────────────────── │
│ NEW BOM FILE │  Part Number  │ Mfr Name    │ Qty        │
│ [new.xlsx ]… │  GRM188R61... │ Murata      │ 100        │
│ ▶ Compare   │                                           │
│              │  ⚡ Lifecycle タブ                        │
│ DIGIKEY API  │  GRM188R61... │ 🔴 Obsolete              │
│ [Client ID ] │  LQW18AN10... │ 🟠 NRND                  │
│ [Secret    ] │                                           │
│⚡ Check Life.│  SUBSTITUTES                              │
│ MOUSER API   │  RC0402JR-07  │ Source: DigiKey           │
│ [API Key   ] │  GRM155R61... │ Source: Mouser            │
│⚡ Check Msr. │                                           │
│ SUMMARY      │                               ⚙ 設定     │
│ Obsolete [ 2]│                                           │
│ NRND     [ 1]│                                           │
└──────────────┴──────────────────────────────────────────┘

環境・使用技術

  • Python 3.11+
  • tkinter(標準ライブラリ、GUI)
  • pandas(Excel読み込み・差分検出)
  • openpyxl(Excelレポート出力)
  • requests(DigiKey / Mouser API通信)
  • DigiKey Product Information API v4
  • Mouser Search API v2

セットアップ

1. クローン&インストール

git clone https://github.com/bluerey0331/bom_diff_tool.git
cd bom-diff-tool
pip install -r requirements.txt

requirements.txt はシンプルです。

pandas>=2.0.0
openpyxl>=3.1.0
requests>=2.31.0

2. 設定ファイルの作成

cp config.ini.example config.ini

config.ini にAPI認証情報を記入します(後述)。

3. 起動

python main.py       # GUIモード
python main.py --cli # CLIモード

使い方:基本のBOM比較

STEP 1:Prepareツールで前処理(任意)

現場のExcelにはBOM比較に不要な列(Unit Price、Lead Timeなど)が含まれていることが多いです。Prepareツールで必要な4列だけを残します。

python prepare.py

起動すると、ファイルを選ぶとカラム一覧がチェックボックスで表示されます。

  • ✅ 残す列(緑):⚙設定で定義した4列が自動的にON
  • ☐ 削除する列(赤):それ以外はデフォルトOFF

old.xlsx / new.xlsx として保存して完了。

STEP 2:BOM比較

  1. old.xlsx(旧BOM)と new.xlsx(新BOM)を選択
  2. ▶ Compare をクリック
  3. 結果が4つのタブに表示される
タブ 内容
+ Added 新BOMにのみある部品
- Removed 旧BOMにのみある部品
△ Qty Changed 数量が変わった部品
△ Mfr Changed メーカーが変わった部品

STEP 3:Excelレポートを保存

↓ Save Excel Report でレポートを保存。4つのシートに整理して出力されます。


使い方:ライフサイクルチェック(DigiKey / Mouser API)

BOM比較後、そのまま部品のライフサイクルも確認できます。

DigiKeyの場合

  1. DigiKey Developer Portal でアプリを登録
  2. Client ID と Client Secret を取得
  3. 左パネルに入力して ⚡ Check DigiKey をクリック

Mouserの場合

  1. Mouser API Hub からSearch APIを申請(メールでキーが届く)
  2. 左パネルに入力して ⚡ Check Mouser をクリック

APIキーは config.ini に書いておくと次回から自動読み込みされます。

[digikey]
client_id     = xxxxxxxxxxxxxxxx
client_secret = xxxxxxxxxxxxxxxx

[mouser]
api_key = xxxxxxxxxxxxxxxx

結果はLifecycleタブに色分け表示されます。

色 ステータス 意味
🔴 赤 Obsolete 廃品(製造中止)
🟠 橙 NRND 新規設計非推奨
🟢 緑 Active 現行品
⬛ グレー Unknown 未登録

廃品・NRNDの行をクリックすると、下部の代替品テーブルに候補が表示されます。どのAPIで取得したかも「Source」列で確認できます。


実装のポイント

1. カラム名を設定ファイルで管理する

現場ごとにBOMのカラム名が違う問題を解決するため、カラム名を config.ini で管理しています。

# src/column_config.py(抜粋)

DEFAULT_COLUMNS = {
    "part_number":  "Manufacturer Part Number",
    "manufacturer": "Manufacturer Name",
    "quantity":     "Requested Quantity 1",
    "description":  "Description",
}

def get_required_columns() -> list[str]:
    """設定から必須カラム名リストを返す"""
    config = _read_ini()
    return [
        config.get("columns", key, fallback=default).strip()
        for key, default in DEFAULT_COLUMNS.items()
    ]

loader.py・comparator.py・report.py はすべてこの関数を参照するため、設定を変えるだけで全体に反映されます。GUIの ⚙設定 ボタンからも変更可能です。

2. DigiKey と Mouser で共通インターフェースを使う

2つのAPIを同じ形式で返すようにしています。

# 共通の戻り値フォーマット
{
    "part_number":  "GRM188R61A106KE69D",
    "lifecycle":    "obsolete",   # active / nrnd / obsolete / unknown
    "status_label": "Obsolete",
    "substitutes":  [
        {
            "mfr_part_number": "GRM188R61A106KE69J",
            "manufacturer":    "Murata",
            "source":          "digikey",  # or "mouser"
        }
    ],
    "error": "",
}

GUIとレポート出力はこのフォーマットだけを扱うため、APIが増えても変更が最小限になります。

3. Mouser APIの代替品は1回のリクエストで取得できる

DigiKeyはSubstitutionsエンドポイントへの別リクエストが必要ですが、Mouserは1回の検索レスポンスに SuggestedReplacement フィールドが含まれています。

# src/mouser_client.py(抜粋)

def _parse_substitutes(suggested: str) -> list[dict]:
    """カンマ区切りの代替品文字列をリストに変換"""
    if not suggested:
        return []
    return [
        {"mfr_part_number": pn.strip(), "source": "mouser"}
        for pn in suggested.split(",")
        if pn.strip()
    ]

4. GUIのブロッキングを防ぐ

API呼び出しは threading.Thread で別スレッドで実行し、UIが固まらないようにしています。

# src/gui.py(抜粋)

def _run_digikey_check(self):
    self._dk_btn.config(state="disabled", text="Checking…")
    threading.Thread(
        target=self._digikey_worker,
        args=(client_id, client_secret),
        daemon=True
    ).start()

def _digikey_worker(self, client_id, client_secret):
    # バックグラウンドで1件ずつ処理
    for i, pn in enumerate(self._new_part_numbers):
        lc = client.check_lifecycle(pn)
        # UIへの更新は after() でメインスレッドに渡す
        self.after(0, self._on_dk_progress, i + 1, total, pn, lc)
    self.after(0, self._on_dk_done, results)

プロジェクト構成

bom-diff-tool/
├── main.py               # エントリーポイント
├── prepare.py            # 前処理ツール
├── requirements.txt
├── config.ini.example    # 設定テンプレート
├── sample_old.xlsx       # サンプルBOM(旧)
├── sample_new.xlsx       # サンプルBOM(新)
└── src/
    ├── column_config.py     # カラム名設定
    ├── comparator.py        # 差分検出ロジック
    ├── digikey_client.py    # DigiKey API
    ├── mouser_client.py     # Mouser API
    ├── gui.py               # メインGUI
    ├── loader.py            # Excel読み込み
    ├── preprocessor.py      # 前処理ロジック
    ├── report.py            # Excelレポート出力
    └── settings_dialog.py   # 設定ダイアログ

テストは pytest で書いており、GitHub Actions で Python 3.11 / 3.12 の自動テストが走ります。

pip install pytest
pytest tests/ -v

サンプルデータで試してみる

リポジトリにはすぐ試せるサンプルデータが含まれています。

cp sample_old.xlsx old.xlsx
cp sample_new.xlsx new.xlsx
python main.py

サンプルには以下の変更点が仕込まれています。

変更種別 部品番号
追加 RC0402JR-070R1L
削除 MMBT3904LT1G
Qty変更 LQW18AN10NG00D(50→80)
Mfr変更 ERJ-2RKF1001X(Panasonic→Yageo)

まとめ

本記事のまとめです。

  • BOM差分比較はpandasのDataFrameインデックス比較で実現(シンプル&高速)
  • カラム名の柔軟対応は設定ファイル集約パターンで解決
  • DigiKey / Mouser APIの統合は共通インターフェースで最小限の変更に
  • GUIのブロッキング防止はthreading + after()で対応

現場で実際に使いながら機能を足していったので、「あったらいいな」が詰まっています。IssueやPRも歓迎です。

GitHubリポジトリ
https://github.com/bluerey0331/bom_diff_tool

MITライセンス・商用利用可能です。


参考

0
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?