asukapy

クラス設計・OOP入門

Pythonで作る「壊れにくいスクリプト」共通設計5原則|可読性・型・副作用・テスト・性能まで

Pythonで「壊れにくいスクリプト」を作る共通設計5原則を、可読性・型ヒント・副作用の管理・テスト自動化・性能/スケールの観点で整理。Ruffやmypy、Blackなど品質チェックの導入手順も具体例つきで解説します。
Python入門

Python初心者が知らない「標準ライブラリで十分な場面」完全ガイド|外部ライブラリ前に読む話

Python初心者向けに「標準ライブラリで十分な場面」を用途別に整理。pathlib・json・logging・argparse・sqlite3など、外部ライブラリに頼る前に知っておきたい機能と判断基準をまとめました。
クラス設計・OOP入門

Pythonで設定ミスを即検知!起動時バリデーション設計(Pydantic Settings対応)

Pythonの設定ミスを“起動時”に一括検知する設計を解説。YAML/TOML/.envの使い分け、Pydantic Settingsでの型変換・検証、運用のコツまで具体例付きで紹介。
仮想環境・インフラ構築

Pythonのログは「出す」より「読む」設計が9割|障害対応で差がつく実践パターン

Pythonのログは「出す」より「読む」設計が重要。printやルートロガー依存の落とし穴を避け、dictConfigで設定を集中管理し、JSON構造化・コンテキスト付与・機密マスキングまで“障害対応で効く”実践ポイントをまとめます。
Python入門

Python初心者が「import地獄」に陥る理由|循環参照・sys.path・正しいモジュール設計

Python初心者がハマりやすい「import地獄」の原因を、循環参照(circular import)・sys.pathの探索順・ディレクトリ構成の失敗から整理。srcレイアウトや__init__.pyの使い方、from importが失敗しやすい理由、ruffでのimport整理まで、再発しない設計を解説します。
クラス設計・OOP入門

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

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

Pythonの「設定値はどこに置くべきか?」実務で迷わない判断フロー(ENV/.env/TOML/Secretsまで)

Pythonの設定値を「どこに置くべきか」を、実務向けの判断フローで整理。アプリ設定・環境依存・シークレットの分類から、ENV/.env、TOML/YAML、Pydantic Settings、Secret Manager運用まで、事故を防ぐ定石をまとめます。
クラス設計・OOP入門

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

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

Python初心者が「標準ライブラリだけ」でどこまで戦えるか完全マップ|できること総まとめ

Python初心者向けに、標準ライブラリだけで「何ができるか」を分野別に地図化。テキスト処理・ファイル操作・JSON/CSV・SQLite・並行処理・HTTP・テスト・GUIまで、外部ライブラリに頼らない実装の入口と代表モジュールをまとめて解説します。
クラス設計・OOP入門

Pythonの境界設計とは?I/Oとロジック分離で“変更に強い”コードにする方法

Pythonの「境界設計」を図解感覚で解説。I/O(DB・API・UI)とビジネスロジックを分離し、変更に強くテストしやすい設計へ。Protocol/ABC、依存性逆転、DIの実装手順も紹介。