最近更新されたページ
Python OSSの読み解き方
① 🚀 はじめに（What / Why） このページで理解できる到達点はこれ。 PythonのOSSを「雰囲気」ではなく、継続利用に耐えるかという観点で短時間に判定できる READMEを読んで...
なぜPythonはOSSが強いのか
① 🚀 はじめに（What / Why） このページで理解したい到達点はこれ。 PythonのOSSが「強い（層が厚く、実務で戦える）」のは、偶然ではなく言語の思想・標準ライブラリの方針・合意...
🧾 VS Code「Markdown PDF」で改ページを制御する方法（BookStack向け）
🧭 はじめに この記事では、VS Code拡張機能「Markdown PDF」 を使ってMarkdown文書をPDF化する際に、意図した位置で改ページを入れる方法を整理する。 Markdown自...
dataclassのミュータブルとイミュータブルの違いと使い分け
🐍はじめに ここでは、dataclassでの「ミュータブルとイミュータブルの違い」と、その使い分けの指針について解説していきます！ ⚔️ ミュータブル vs イミュータブル：違いと比較 項目ミ...
🧠 lru_cache を使った「遅延・一度きり」の logger 初期化
🧭 はじめに（What） このページでは、 functools.lru_cache(maxsize=1) を使って logging の「セットアップだけ」を一度に制御する設計パターン を解説する...
🧱 シングルトンは「モジュール」で作る
🧭 はじめに（What） このページでは、Python におけるシングルトンの定石を整理する。 結論は明確で、Python ではシングルトンを「クラス」で作らない。 代わりに、モジュールそのもの...
🔍 状態と副作用を隠さない
NIP
✂️ 関数は短く、意図で分割する
NIP
🗂️ モジュール境界を設計境界にする
NIP
🦆 インターフェースは作らない（必要になるまで）
NIP
⚙️ 設定はコードで表す
NIP
🚧 エラー処理は境界に集約する
NIP
🧬 クラスはデータと振る舞いを一緒に持つ
NIP
🧩 継承を使わない（合成も最小限）
NIP
🧨 賢そうに見えるが読めないコード（Readability counts / Beautiful is better than ugly）
🧭 はじめに このページでは、「短い・凝っている・トリッキー」なコードが必ずしも良いコードではないことを整理する。 Python の Zen が繰り返し強調する Readability coun...
📦 名前空間破壊（Namespaces are one honking great idea）
🧭 はじめに このページでは、import * に代表される名前空間の破壊を、単なるスタイル違反ではなく設計不良として整理する。 Python の Zen にある Namespaces are ...
🛣️ “やり方が複数”の増殖（One obvious way to do it）
🧭 はじめに このページでは、「同じことをするコードが、複数の流儀で書かれている」状態が、チーム開発において最も高コストになるという事実を整理する。 Python の Zen が言う There...
🧩 過剰抽象・早すぎる一般化（Simple is better than complex）
🧭 はじめに このページでは、「将来の拡張」を理由に今のコードを不必要に複雑化してしまうアンチパターンを整理する。Python の Zen がいう Simple is better than c...
🧠 推測に頼るコード（Refuse the temptation to guess）
🧭 はじめに このページでは、Python の Zen Refuse the temptation to guess に反するアンチパターン、 「推測に頼るコード」 を扱います。 Python ...
🤐 例外の黙殺（Errors should never pass silently）
🧭 はじめに このページでは、Python の Zen Errors should never pass silently に真正面から反するアンチパターン、 「例外の黙殺」 を扱います。 例外...