設計

クラス設計・OOP入門

Pythonで状態管理(State Management)を理解する|FSMとStateパターンの基本

Pythonの状態管理を、巨大なif文(条件分岐)から脱出する視点で解説。FSM(有限状態機械)とState/Observer/Mementoの使い分け、transitionsによる状態遷移の実装、図解化(Mermaid/Graphviz)のコツまでまとめて学べます。
クラス設計・OOP入門

PythonのI/Oが散らかる原因と直し方|実例で学ぶ「境界」の分離設計

PythonでI/O(DB・API・ファイル・UI)とビジネスロジックが密結合して辛い人向けに、実例で「分離設計」の手順を解説。Repository/Protocol/DIでテスト容易性と変更耐性を上げます。
クラス設計・OOP入門

Pythonの「小さな設計ミス」が後で地獄を見るパターン10選|コードスメル&負債の潰し方

Python開発でよくある「小さな設計ミス」が、数か月後に大炎上する理由を10パターンで整理。例外の握りつぶし、巨大クラス、重複コード、深いネストなど“地獄の種”を、具体的な改善手順(Extract Method/Class、早期リターン、静的解析・レビュー運用)までまとめて解説します。
クラス設計・OOP入門

Pythonの依存関係注入(DI)をやさしく解説|テストしやすい設計への第一歩

Pythonの依存関係注入(DI)を、密結合の問題→解決の考え方→実装(コンストラクタ注入・メソッド注入・FastAPI Depends・DIフレームワーク)までやさしく解説。モック差し替えでテストしやすい設計に変える手順がわかります。
クラス設計・OOP入門

Pythonの例外を「投げる側」設計ベストプラクティス|raiseの判断基準と失敗しない流儀

Pythonの「例外を投げる(送出する)側」に焦点を当て、組み込み例外とカスタム例外の使い分け、例外メッセージ設計、raise fromによる連鎖、Python 3.11+のadd_note/ExceptionGroupまで実務目線で整理します。
Python入門

Pythonの例外設計入門|try/exceptを「どう設計するか」まで徹底解説

Pythonのtry/exceptを“書ける”から“設計できる”へ。例外を握りつぶさない方針、catch範囲の決め方、独自例外の作り方、raise from・ログ・リソース解放まで、実務で困らない例外設計をまとめて解説します。