【要約】【Python入門】カウントダウンタイマーCLIを作ってみた ─ time・finally・mockで学ぶ時間制御と例外テスト [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者が、時間制御と例外処理を伴うCLIツールを実装する際、以下の技術的課題に直面した。
- ・表示のUX：カウントダウンが縦に並んでしまい、タイマーとしての視認性が低い。
- ・例外設計：ユーザーによる中断（Ctrl+C）を適切にハンドリングし、終了処理を確実に実行できない。
- ・テストの困難性：time.sleepをそのまま使用するとテスト実行が極端に遅延し、かつ例外の注入が困難である。
// Approach
開発者は、Pythonの標準機能とpytestを活用し、以下の手法で課題を解決した。
- ・表示制御：\r（キャリッジリターン）とflush=Trueを用い、同一行での上書き表示を実現した。
- ・例外設計：try/except/finally構造を用い、KeyboardInterruptの捕捉と、成否に関わらず実行される終了メッセージの集約を行った。
- ・テスト戦略：unittest.mock.patchでtime.sleepを差し替え、side_effectで例外を注入。capsysで標準出力をキャプチャして検証した。
// Result
開発者は、実装とテストの両面において、以下の成果を得た。
- ・実装面：責務の分離（main.pyとtimer.py）と、UXを考慮した表示制御を実現した。
- ・テスト面：mockの適切な対象選定と、アサーションの範囲を最小限に絞ることで、堅牢で高速なテストコードを構築した。これにより、時間依存のロジックに対するテスト手法を確立した。
Senior Engineer Insight
> 実戦的な観点から、本記事は「副作用を伴うコードのテスト手法」として価値が高い。特に、time.sleepのような外部依存をpatchで制御し、side_effectで異常系をシミュレートする手法は、リアルタイム性が求められるシステムにおけるユニットテストの定石である。また、finallyを用いた終了処理の設計は、堅牢なシステム構築の基礎となる。ただし、大規模システムではprintによる表示制御ではなく、ロギングライブラリの適切な利用が求められる点に留意すべきだ。