株式会社Good Labでエンジニアをしている コータロー です。
日々、Java・SQL・Gitなどの技術情報や、新人エンジニア向けの学習ノウハウ、
AI活用についての情報を発信しています。
Good Labについて気になった方は、コーポレートサイトもぜひご覧ください。
▶コーポレートサイト
はじめに
「Java経験者のためのPython入門」第4回(最終回)です。第3回の「Excel の管理表と pom.xml の差分ツール」を他人が作った既存ツールに見立てて、読む → 直す → 確かめる → EXE を作り直す、を一通りやります。
| 項目 | 動作確認した環境 |
|---|---|
| OS / Python | macOS / Python 3.14.8。openpyxl 3.1.5、tkinter(Tk 9.0) |
| 検証用 venv | PyInstaller 6.22.3 / pandas 3.0.6 / lxml 6.1.3 / beautifulsoup4 4.15.0 / xlrd 2.0.2 |
- Windows では一切動かしていません。 Windows の話は公式ドキュメントで裏付けたものは根拠を示し、それ以外は「未検証」と明記します
- 第3回と同じく
str | Noneは 3.10 以降の書き方です(3.9 以前は先頭にfrom __future__ import annotations)。ほかに版で違う所はその場で注記します
1. 既存ツールを読む順番
| 順番 | 見る所 | 第3回のツールでは |
|---|---|---|
| 1 | 入口(if __name__ == "__main__":、.spec の Analysis(['main.py'], ...)) |
main.py(画面)と diff_core.py の末尾(コマンド)の2つ |
| 2 | 先頭の import 行 |
tkinter・openpyxl・ElementTree(2章) |
| 3 | ロジックと画面の境目 |
diff_core.run()。画面もコマンドもここだけを呼ぶ |
| 4 |
try / except の場所 |
run_compare() の1か所だけ(5章) |
2. import 行からライブラリを見分ける
画面
| import 行 | ボタン処理の探し方 |
|---|---|
import tkinter as tk |
command= に渡した関数(第3回) |
import PySimpleGUI as sg |
window.read() を回す while True: の中の if event == ...
|
from PyQt5.QtWidgets import ... / from PySide6...
|
button.clicked.connect(...) の接続先 |
import wx |
self.Bind(wx.EVT_BUTTON, ...) の接続先 |
Swing の addActionListener に当たる1行を探します(tkinter 以外は動作未確認の目安)。PyQt5 ではスロットの未処理例外で qFatal() が呼ばれ、既定ではアプリが終了します(公式ドキュメント)。
Excel
| import 行 | 性質 |
|---|---|
from openpyxl import load_workbook |
.xlsx をファイルとして読む。計算はしない |
import pandas as pd |
pd.read_excel()。.xlsx は openpyxl で読み、DataFrame で扱う |
import xlrd |
2.0.0(2020年12月)から .xls 専用 |
import xlwings as xw |
Excel 本体を操作する。公式ドキュメントでは Excel のインストールが必要 |
pandas と xlrd を第3回の libraries.xlsx で試しました。
>>> import pandas as pd
>>> df = pd.read_excel("libraries.xlsx", sheet_name=0)
>>> df["version"].tolist()
['2.0.16', '1.5.6', '5.11.3', 1.1, '2.16.1', nan, '2.0.16']
- 空行は飛ばされず、空セルは
Noneではなくnan - 数値の
1.10は1.1。dtype=strを付けても'1.1'でした(元の表記には戻らない) -
「NA」「None」「null」という文字のセルも既定で
nan。別ファイルで['slf4j-api', nan, nan, nan]になり、keep_default_na=Falseで['slf4j-api', 'NA', 'None', 'null']に戻りました - xlrd 2.0.2 で .xlsx を開くと
xlrd.biffh.XLRDError: Excel xlsx file; not supported
XML
同じ pom.xml を lxml と BeautifulSoup で読みます。
>>> from lxml import etree
>>> root = etree.parse("pom.xml").getroot()
>>> len(root.findall("dependencies/dependency")), len(root.findall("{*}dependencies/{*}dependency"))
(0, 5)
>>> len(list(root.iter("{*}dependency")))
6
>>> from bs4 import BeautifulSoup
>>> with open("pom.xml", encoding="utf-8") as f:
... soup = BeautifulSoup(f, "xml")
...
>>> len(soup.find_all("dependency"))
6
>>> [d.artifactId.get_text() for d in soup.project.dependencies.find_all("dependency")]
['junit-bom']
>>> deps = soup.project.find("dependencies", recursive=False)
>>> len(deps.find_all("dependency", recursive=False))
5
-
lxml は ElementTree とほぼ同じ API ですが、
iter("{*}dependency")は ElementTree では0件(第3回)なのに、lxml では木全体から6件取れます -
BeautifulSoup(
"xml"には lxml が必要)は名前空間を書かずに取れる代わりに、場所を限定しないと第3回の落とし穴2(junit-bom が混ざる)を踏みます。soup.project.dependenciesは「最初に見つかった子孫」なので、dependencyManagementの中の junit-bom だけが返りました
3. EXE の正体を見分ける
最初に「元の .py が手元にあるか」を確かめます。 PyInstaller で固めた EXE は直接編集できず、元の .py を直して作り直します。
| 手がかり | 正体 |
|---|---|
EXE の隣に _internal フォルダ、ソース側に .spec
|
PyInstaller(onedir。6.0 以降) |
| EXE が1個だけ | PyInstaller(onefile)など |
.bat やショートカットの中身が python main.py / pythonw main.py
|
ランチャー(.py をそのまま呼ぶ) |
from cx_Freeze import setup の setup.py、build/exe.〜 フォルダ |
cx_Freeze |
ソースに # nuitka-project: のコメント、〜.dist フォルダ |
Nuitka |
_internal は PyInstaller 6.0.0(2023-09-22)からの構成です(変更履歴)。onefile は起動中だけ一時フォルダ _MEI〜 に展開します(公式ドキュメント)。
macOS で onedir を作ると、_internal/ に libpython3.14.dylib・python3.14/・Tcl/Tk 関係・同梱したファイルなどができ、固めたときの Python のバージョンが分かりました。Windows では python314.dll のような名前のはずですが未検証です。
4. 開発環境を作る
ツール専用の venv(Maven のプロジェクトごとの依存に近いもの)を、EXE を作ったときと同じ Python のバージョンで作ります。
py -m venv .venv
.venv\Scripts\activate.bat
python -m pip install -r requirements.txt
- macOS は
source .venv/bin/activate。PowerShell は.venv\Scripts\Activate.ps1 -
requirements.txtが無ければ、動く環境でpython -m pip freeze > requirements.txt。.venvは Git に入れません - Windows の
pyは、3.14 からは Python install manager が提供します。一覧はpy list、版の指定はpy -V:3.14。旧ランチャーのpy --list・py -0も互換で残っています(公式ドキュメント。未検証)
5. エラーが見えない問題
第3回の run_compare() は例外を messagebox に出していました。では try の外で例外が起きたらどうなるかを確かめます。
import tkinter as tk
def on_click():
print("on_click 開始")
raise ValueError("ボタンの処理で失敗")
def main():
root = tk.Tk()
button = tk.Button(root, text="押す", command=on_click)
button.pack()
def scenario():
button.invoke() # ボタンを押したことにする
print("invoke の後も処理は続く")
root.destroy()
root.after(100, scenario)
root.mainloop()
print("mainloop 終了")
if __name__ == "__main__":
main()
on_click 開始
invoke の後も処理は続く
mainloop 終了
標準エラー出力には Exception in Tkinter callback とトレースバック(最終行 ValueError: ボタンの処理で失敗)が出ました。Tk が例外を受け止めて標準エラー出力に書くだけで、プログラムは止まらず、画面にも出ません。
公式ドキュメントには「コンソールの無い Windows の GUI アプリや pythonw では sys.stdout と sys.stderr が None になりうる」とあり、macOS で両方を None にして動かすと何も表示されませんでした(模擬)。--windowed の EXE ではボタンを押しても何も起きないように見えるわけです。PyInstaller の windowed には未処理例外を表示する仕組みがありますが(公式ドキュメント)、Tk が受け止めた例外はそこまで抜けません(Windows での表示は未検証)。
対策は3つです。
-
.py をコマンドプロンプトから直接実行する(
python main.py)。調査はまずこれ -
report_callback_exceptionを差し替える。3.14 の tkinter のソースにも「sys.stderrがNoneなら上書きすべき」とあります(7章で確かめます) - logging でファイルに書く(7章)
6. 安全な直し方
- 直す前に元を残す(Git でコミット、無ければフォルダごとコピー)
-
直す前の出力を保存し、直した後と
diffで比べる。テストの無い既存ツールでは、これがテストの代わり - ロジック関数を GUI なしで呼んで確かめる
- 差分は小さく、修正依頼1件ごとに確かめる
7. 練習:見本ツールに修正依頼を2件入れる
第3回の見本をコピーして2件直します(結果は samples/04_fixed/)。
-
依頼1:
<scope>test</scope>の依存(junit など)は管理表の対象外なので、比較から外してほしい - 依頼2:結果を CSV で保存して、Excel で開きたい
サンプルの pom.xml には test スコープの依存がすでに2件(junit-jupiter・mockito-core)あるので、そのまま使います。まず直す前の出力を残します。
python make_sample_excel.py
python diff_core.py libraries.xlsx pom.xml > before.txt
python diff_core.py libraries.xlsx pom.xml --raw > before_raw.txt
依頼1:1回目の直し(失敗例)
pom.xml を読むのは read_pom() なので、まずそこで test スコープを読み飛ばしてみました。
for dep in root.findall("{*}dependencies/{*}dependency"):
+ if dep.findtext("{*}scope") == "test": # 依頼1(1回目の直し)
+ continue
4,5c4
< [pomにだけある] 'org.mockito:mockito-core' None / '5.14.2' 管理表に載っていない
< [一致] 'org.junit.jupiter:junit-jupiter' '5.11.3' / None pomに版の記載なし(親・BOMで管理)
---
> [Excelにだけある] 'org.junit.jupiter:junit-jupiter' '5.11.3' / None もう使っていない?
9c8
< {'Excelにだけある': 1, 'pomにだけある': 1, '一致': 2, '版が違う': 2}
---
> {'Excelにだけある': 2, 'pomにだけある': 0, '一致': 1, '版が違う': 2}
mockito-core が消えたのは狙いどおりですが、junit-jupiter が「Excelにだけある(もう使っていない?)」に移りました。 管理表に行が残っているので、pom 側だけ外すとこうなります。実際には使っているので誤った指摘です。件数だけ見ていたら「pomにだけある が0件、直った」で終わっていたかもしれません。
依頼1:直した版
pom.xml で test スコープだったキーを、管理表の側からも外します。
KINDS = ("Excelにだけある", "pomにだけある", "一致", "版が違う")
+# 管理表の対象外なので比較から外すスコープ(依頼1)
+SKIP_SCOPES = frozenset({"test"})
@@
version: str | None # None は「版の記載なし」
+ scope: str | None = None # pom の <scope>。管理表から読んだときは None
@@
- to_text(version, normalize_text)))
+ to_text(version, normalize_text),
+ to_text(dep.findtext("{*}scope"), normalize_text)))
@@
-def compare(excel_libs: list[Library], pom_libs: list[Library]) -> list[DiffRow]:
+def compare(excel_libs: list[Library], pom_libs: list[Library],
+ skip_scopes: frozenset[str] = SKIP_SCOPES) -> list[DiffRow]:
"""groupId:artifactId で突き合わせ、4つに分類する。"""
+ skipped = {lib.key for lib in pom_libs if lib.scope in skip_scopes}
excel: dict[str, Library] = {}
for lib in excel_libs:
- excel.setdefault(lib.key, lib) # 重複したら先の行を使う
- pom = {lib.key: lib for lib in pom_libs}
+ if lib.key not in skipped: # 管理表に残っていても比べない
+ excel.setdefault(lib.key, lib) # 重複したら先の行を使う
+ pom = {lib.key: lib for lib in pom_libs if lib.key not in skipped}
-
scopeは既定値None付きなので、read_excel()のLibrary(group, artifact, version)はそのまま動きます - 外すスコープは引数の既定値です。
frozenset(変更できない set)なので第2回の「ミュータブルなデフォルト引数」の罠を踏まず、確認のときだけ別の値を渡せます
確かめる
>>> import diff_core
>>> excel_libs, _ = diff_core.read_excel("libraries.xlsx")
>>> pom_libs = diff_core.read_pom("pom.xml")
>>> diff_core.count_by_kind(diff_core.compare(excel_libs, pom_libs))
{'Excelにだけある': 1, 'pomにだけある': 0, '一致': 1, '版が違う': 2}
>>> diff_core.count_by_kind(diff_core.compare(excel_libs, pom_libs, skip_scopes=frozenset()))
{'Excelにだけある': 1, 'pomにだけある': 1, '一致': 2, '版が違う': 2}
何も外さない skip_scopes=frozenset() では、行の中身まで直す前と一致しました。直した後の出力を after.txt に保存して比べます。
4,5d3
< [pomにだけある] 'org.mockito:mockito-core' None / '5.14.2' 管理表に載っていない
< [一致] 'org.junit.jupiter:junit-jupiter' '5.11.3' / None pomに版の記載なし(親・BOMで管理)
9c7
< {'Excelにだけある': 1, 'pomにだけある': 1, '一致': 2, '版が違う': 2}
---
> {'Excelにだけある': 1, 'pomにだけある': 0, '一致': 1, '版が違う': 2}
消えたのは test スコープの2行と件数だけで、移動した行はありません。--raw でも同じ2行が消え、件数が pomにだけある 2 → 1・一致 1 → 0 に変わっただけでした。意図した所だけ変わったと言えます。
依頼2:CSV に書き出す
diff_core.py に関数を足し、コマンドの引数を argparse に置き換えて --csv を付けました(import sys は不要になり、import argparse と import csv を足しています)。
def write_csv(rows: list[DiffRow], path: str) -> None:
"""Excel で開く前提で、BOM 付き UTF-8 で書く(依頼2)。"""
with open(path, "w", encoding="utf-8-sig", newline="") as f:
writer = csv.writer(f)
writer.writerow(["分類", "groupId:artifactId", "管理表の版", "pomの版", "備考"])
for r in rows: # None は空欄になる
writer.writerow([r.kind, r.key, r.excel_version, r.pom_version, r.note])
# ...(run() は変更なし)...
if __name__ == "__main__":
parser = argparse.ArgumentParser(description="管理表と pom.xml の依存関係を突き合わせる")
parser.add_argument("excel", help="管理表(.xlsx)")
parser.add_argument("pom", help="pom.xml")
parser.add_argument("--raw", action="store_true", help="表記ゆれを正規化しない")
parser.add_argument("--csv", metavar="出力.csv", help="結果を CSV にも保存する")
args = parser.parse_args()
rows, warnings = run(args.excel, args.pom, normalize_text=not args.raw)
# ...(表示の4行は変更なし)...
if args.csv:
write_csv(rows, args.csv)
-
newline=""は csv の公式ドキュメントが求める書き方。utf-8-sigは先頭に BOM を付ける UTF-8 で、Excel で文字化けせず開けるかは未検証です(Excel は起動していません) - 書いた CSV は、先頭3バイトが
b'\xef\xbb\xbf'、行末が\r\n、見出し+4行で、Noneは空欄でした。書き込み権限の無いフォルダではPermissionError: [Errno 13] Permission denied: 'ro/x.csv' - 第3回で省いた引数チェックも直りました。
python diff_core.py libraries.xlsxは、直す前はIndexError: list index out of range(終了コード 1)、直した後は使い方とdiff_core.py: error: the following arguments are required: pom(終了コード 2)です
main.py の変更
[CSV保存]ボタン(save_csv())は、run_compare() が持っておく直近の結果 self.rows を write_csv() で書き、OSError は messagebox で知らせます。self.rows は比較の最初に空にし、表に入れ終えてから設定します(エラー時に古い結果を保存させないため)。あわせて5章の対策も入れました(依頼とは別なのでコミットは分けます)。以下は抜粋です(全体は samples/04_fixed/main.py)。
# ...(app_dir() は8章で説明)...
LOG_PATH = app_dir() / "diff_tool.log"
# ...(DiffApp は省略)...
def report_callback_error(exc, val, tb) -> None:
"""ボタンなどの処理で捕まえ損ねた例外を、ログと画面の両方に出す。"""
logging.error("画面の処理で例外", exc_info=(exc, val, tb))
messagebox.showerror("予期しないエラー", f"{exc.__name__}: {val}\n詳細は {LOG_PATH} を見てください")
def main() -> None:
logging.basicConfig(filename=LOG_PATH, encoding="utf-8", level=logging.INFO,
format="%(asctime)s %(levelname)s %(message)s")
root = tk.Tk()
root.report_callback_exception = report_callback_error
DiffApp(root)
root.mainloop()
run_compare() の except には logging.exception(...) を足しました。basicConfig() の encoding 引数は 3.9 からです。
GUI を起動し、after() からボタンを invoke() して確かめました(ダイアログは記録用の関数に差し替え)。
| 操作 | 結果 |
|---|---|
| 比較前に[CSV保存] | 警告「先に[比較]を実行してください」 |
| [比較]→[CSV保存] | 表は4行、件数表示は before/after の比較と同じ。CSV は見出し+4行、ログに INFO CSV を保存
|
| 存在しない pom.xml を指定 |
FileNotFoundError を表示、表は空。ログに ERROR 比較に失敗 とトレースバック |
count_by_kind() を 1 / 0 に差し替えて[比較] |
try の外なので report_callback_error() に届き、ZeroDivisionError: division by zero とログのパスを表示 |
最後の行では、表に4行入ったのに件数表示は前回のままでした。report_callback_exception は最後の砦で、後始末は各処理の try で書きます。
8. EXE を作り直す
PyInstaller はクロスコンパイラではありません。 公式ドキュメントに「Windows のアプリを作るには Windows で PyInstaller を実行する」とあり、Mac で Windows 用の EXE は作れません。
pyinstaller --onefile --windowed --name DiffTool main.py
--onedir(既定)か --onefile か、--windowed(コンソールを出さない)、--add-data 元:先(データの同梱。: 区切りは 6.0 から Windows でも可)が主なオプションです。
.spec があるなら pyinstaller DiffTool.spec で作り直します。 入口(Analysis(['main.py'], ...))・同梱ファイル(datas=)・コンソールの有無(console=False)が前回と同じになり、--onefile などのオプションは無視されます(公式ドキュメント)。
同梱したファイルと EXE の隣のファイル
sys.frozen・sys._MEIPASS・sys.executable・__file__・main.LOG_PATH を表示するスクリプトを --add-data pom.xml:. 付きで固め、macOS で実行しました。sys.frozen はどちらも True です(パスは短くしています)。
| 項目 | onedir | onefile |
|---|---|---|
sys._MEIPASS |
dist/probe_dir/_internal |
一時フォルダ …/T/_MEI…
|
sys.executable |
dist/probe_dir/probe_dir |
dist/probe_one |
__file__ |
dist/probe_dir/_internal/probe.py |
一時フォルダ内の probe.py
|
main.LOG_PATH |
dist/probe_dir/diff_tool.log |
dist/diff_tool.log |
-
同梱したファイル(pom.xml)は
Path(__file__).parentから見つかりました。公式ドキュメントも 4.3 以降は__file__を勧めています -
利用者が置く設定ファイルやログは
sys.executableのフォルダ(EXE の隣)に置きます。onefile の一時フォルダは終了後に残っておらず、onedir でも__file__は_internalの中だからです。main.pyのapp_dir()はgetattr(sys, "frozen", False)が真ならPath(sys.executable).parentを返します。固めて起動すると、ログは実行ファイルの隣にできました(起動のみ確認。書き込み権限の無いフォルダは未検証)
作り直しは専用の venv で。 main.py を onedir で固めると、pyinstaller と openpyxl だけの venv では 29MB、pandas・lxml なども入れた検証用 venv では 48MB でした(macOS)。後者には main.py が使っていない numpy と lxml が入っていました(openpyxl が、入っていれば使う形で import しているため)。requirements.txt から作った venv で作り直しましょう。
9. Windows で動かすときの注意
パスの書き方
>>> p = "C:\temp\new.xlsx"
>>> print(p)
C: emp
ew.xlsx
>>> from pathlib import PureWindowsPath
>>> w = PureWindowsPath("C:/temp") / "new.xlsx"
>>> print(str(w), w.suffix, w.parent)
C:\temp\new.xlsx .xlsx C:\temp
-
\t(タブ)と\n(改行)に化けてもエラーにならないのが怖いところです -
"C:\Users\me\libraries.xlsx"は\UのせいでSyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \UXXXXXXXX escape -
"C:\data\pom.xml"は動きますが、3.14 ではSyntaxWarning: "\d" is an invalid escape sequence. Such sequences will not work in the future. Did you mean "\\d"? A raw string is also an option.が出ます(3.12 から。3.11 以前は既定では表示されないDeprecationWarning) - 直し方は raw 文字列
r"..."、\\、または/と pathlib。raw 文字列は\で終えられません(r"C:\temp\"はSyntaxError: unterminated string literal (detected at line 1); perhaps you escaped the end quote?) - Windows の API は
/を\に正規化します(Microsoft のドキュメント。未検証)
文字コード
open() は encoding を省略すると locale.getencoding() の文字コードを使います。Windows ではこれが ANSI コードページで(公式ドキュメント)、日本語の Windows なら cp932 になりえます(未検証)。macOS では UTF-8 でした。
>>> "𠮷".encode("cp932")
Traceback (most recent call last):
...
UnicodeEncodeError: 'cp932' codec can't encode character '\U00020bb7' in position 0: illegal multibyte sequence
encoding with 'cp932' codec failed
>>> open("u8.txt", encoding="cp932").read() # "管理表,版\n" を UTF-8 で書いたファイル
Traceback (most recent call last):
...
UnicodeDecodeError: 'cp932' codec can't decode byte 0x86 in position 5: illegal multibyte sequence
encode() の例外の最後の行 encoding with 'cp932' codec failed は例外に付いた注記(note)で、3.14 で実行すると表示されました(3.9.6 で同じコードを実行したときは出ませんでした。どの版から付くかは確かめていません)。逆向き(cp932 のファイルを utf-8 で読む)も UnicodeDecodeError でした。
-
open()には必ずencodingを書く("utf-8"、相手が cp932 なら"cp932")。書き忘れはpython -X warn_default_encoding main.pyでEncodingWarning: 'encoding' argument not specifiedとして見つかります(3.10 以降) -
PEP 686 により、Python 3.15 からは UTF-8 モードが既定で、
encoding省略時も UTF-8 になります(元に戻すにはPYTHONUTF8=0か-X utf8=0。What's New 3.15)。3.15 は2026年10月9日に正式リリースされ(PEP 790)、macOS の 3.15.0 でsys.flags.utf8_modeが1、PYTHONUTF8=0で0になることを確かめました。3.14 と 3.15 で読み方が変わるので、明示が一番安全です - Windows ではコンソールの入出力は UTF-8 ですが、
> before.txtのようなリダイレクト先は ANSI コードページで書かれうるので、前後比較は-X utf8でそろえます(公式ドキュメント。未検証)
Excel で開いたままのファイル
openpyxl はディスク上のファイルを読むので、Excel で編集して未保存の内容は読めません。開いたままの .xlsx を読めるか、開いている CSV に上書きするとどうなるかは未検証です。見本は save_csv() で OSError を捕まえ、書けなければ利用者に知らせます。
画面の見た目
macOS(Tk 9.0)の ttk テーマは aqua、TkDefaultFont は .AppleSystemUIFont のサイズ 10 でした。Windows では別のテーマ・フォントになり、日本語が切れるかもしれません(未検証)。
まとめ
- 入口 → import → ロジックと画面の境目 → 例外処理、の順に読む
- ライブラリが変わると同じ書き方でも結果が変わる
- PyInstaller の EXE は元の .py を直し、
.specで、Windows 用は Windows で作り直す - tkinter のボタン処理の例外は
report_callback_exceptionと logging で拾う - 直す前の出力と
diffで比べ、どの行が動いたかを見る - パスは raw 文字列か pathlib、
open()はencodingを明示
確認問題
問1
難易度:⭐
既存ツールは PyInstaller の EXE で、隣に _internal フォルダがあります。.py は見当たりません。処理を直すには、まず何をしますか?
模範解答
元の .py(と .spec・requirements.txt)を探します。PyInstaller の EXE は直接編集できず、.py を直して(Windows 用なら Windows で)作り直すからです。
問2
難易度:⭐⭐
次のコードの出力は?
p = "C:\temp\new.xlsx"
q = r"C:\temp\new.xlsx"
print(len(p), len(q), p == q)
模範解答
14 16 False
p では \t と \n がそれぞれ1文字になるので2文字短く、raw 文字列の q とは別物です。どちらも正しいエスケープなので SyntaxWarning も出ず、黙って別のパスになります。
問3
難易度:⭐⭐⭐
7章の依頼1を、最初は read_pom() で test スコープを読み飛ばすだけで直しました。件数は「pomにだけある 1 → 0」になり、うまくいったように見えます。この直し方の問題は何で、どうすれば気付けますか?
模範解答
管理表に test スコープの依存(junit-jupiter)の行が残っていると、pom 側からだけ消えるので「Excelにだけある(もう使っていない?)」に移ります。実際には使っているので誤った指摘です。
直す前の出力を保存して diff で比べれば、別の分類に移った行が見えるので気付けます。見本では、test スコープのキーを管理表の側からも外すよう compare() を直し、diff で「2行と件数だけが変わった」ことを確かめました。
シリーズのまとめ
| 回 | テーマ | 持ち帰ること |
|---|---|---|
| 第1回 | 基礎文法 ― Java との違いで覚える | インデント、== と is、コレクション、内包表記 |
| 第2回 | 関数・例外・モジュール | ミュータブルなデフォルト引数、except Exception の握りつぶし、if __name__ == "__main__":
|
| 第3回 | Excel の管理表と pom.xml を突き合わせて、差分を GUI に出すツールを作る | pom.xml の名前空間と {*}、openpyxl の値、NFKC、Counter、ロジックと画面の分離 |
| 第4回(本記事) | 既存ツールを読んで直す | 読む順番、ライブラリと EXE の見分け方、エラーの見える化、前後比較、Windows の注意 |
Python を「読む」のはすぐ慣れます。時間がかかるのは Windows・EXE・Excel といった周りの事情です。既存ツールを直す場面では、1章の順番で地図を描き、直す前の出力を保存するところから始めてみてください。
参考
- PyInstaller:Manual / Using PyInstaller / Run-time Information / Spec Files / Changelog
- Python:open() / sys.stdout / Using Python on Windows / tkinter / logging / csv / What's New 3.12
- Python 3.15:PEP 686 / PEP 790 / What's New 3.15
- pandas.read_excel / xlrd Changes / xlwings Installation / lxml / Beautiful Soup
- PyQt5 Incompatibilities / cx_Freeze / Nuitka
- Microsoft - File path formats on Windows systems
@kotaro_ai_lab
AI活用や開発効率化について発信しています。フォローお気軽にどうぞ!