【要約】ローカルファーストな実験記録アプリをv0.3.1にした — tkinter+xvfbのCIで学んだ3つの罠 [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者が、tkinterを用いたGUIアプリのCI環境（GitHub Actions + xvfb）を構築する際、デスクトップ環境特有の挙動によりテストが不安定になる問題に直面した。具体的には以下の事象が発生した。
- ・ttkbootstrapのStyleがプロセス内シングルトンとして残り、テスト間で状態が干渉する。
- ・WM（ウィンドウマネージャ）のない環境で、transient指定されたダイアログが描画されない。
- ・ttk.PanedWindowのsash位置設定において、ウィンドウ幅が確定する前に実行すると値が0にクランプされる。
// Approach
開発者は、GUIテストの信頼性を確保するために、ライブラリの内部仕様に基づいた回避策を講じた。具体的には以下の手法を採用した。
- ・Style.instanceをNoneに、Publisher.clear_subscribers()を呼び出すことで、テストごとに状態をリセットした。
- ・テスト実行時にwm_transient("")を呼び出し、transient指定を動的に解除した。
- ・afterを用いてウィンドウ幅が確定するまで待機し、設定後に値を読み戻して検証するプロセスを導入した。
- ・データ保護として、os.replaceを用いたアトミック保存と、mtimeおよびSHA-256による2段階の競合検知を実装した。
// Result
開発者は、GUIテストを「失敗を無視する」状態から「正しく検知できる」状態へと改善した。これにより以下の成果を得た。
- ・CI環境におけるGUIテストの安定稼働を実現した。
- ・テストの過程を通じて、ウィンドウ幅に依存するアプリ本体のレイアウトバグを特定した。
- ・アトミック保存と100世代のバックアップにより、実験データの堅牢な保護を実現した。
Senior Engineer Insight
> GUIアプリのCI化における「環境の差異」への深い理解が不可欠である。特にheadless環境での描画タイミングやシングルトン挙動は、実戦的なデバッグ能力を問われる。また、研究データの特性を考慮した「アトミック保存」と「2段階競合検知」の設計は、信頼性が求められる現場において極めて妥当な判断である。テストの自動化が単なる検証に留まらず、アプリ本体のバグ発見に繋がっている点は、開発サイクルとして理想的である。