第1章モダン Python 開発の全体像

Python は学びやすく柔軟なプログラミング言語として、Web 開発、データ分析、AI・機械学習、スクリプト自動化など幅広い分野で利用されています。

しかし、長年にわたりツールの乱立や仮想環境管理の複雑さ、実行速度の遅さが開発者の課題となってきました。本章では、現代の Python 開発がどのように進化し、どのような標準構成が採用されているのか、全体像を整理します。

1.1 Python 開発環境の変遷と課題

従来の Python 開発では、プロジェクトごとに複数の異なるツールを組み合わせて利用することが一般的でした。

パッケージのインストールには pip、仮想環境の作成と分離には venv や virtualenv、パッケージの依存関係解決と固定には pip-tools や Poetry、Pipenv などが用いられてきました。また、コードスタイルの統一には black、インポート文の整列には isort、構文やバグのチェックには flake8、静的型検査には mypy といったように、多数の個別ツールをインストールし、それぞれ個別に設定する必要がありました。

このようなツールの乱立は、セットアップ手順の複雑化、チーム開発における環境差分の発生、CI/CD パイプラインでの実行時間の長期化といった問題を生んでいました。

1.2 pyproject.toml による設定の一元化

以前の Python プロジェクトでは、setup.py、setup.cfg、requirements.txt、.flake8、pyproject.toml など、設定ファイルが複数に分散していました。

これに対し、PEP 517、PEP 518、および PEP 621 によって、プロジェクトのメタデータやビルド設定、各種開発ツールの設定を単一の pyproject.toml に集約する標準化が進められました。

[project]
name = "my-project"
version = "0.1.0"
description = "モダン Python プロジェクトのサンプル"
readme = "README.md"
requires-python = ">=3.12"
dependencies = [
    "httpx>=0.27.0",
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

現在では、プロジェクトの依存関係だけでなく、フォーマッターやリンター、型チェッカーの設定も pyproject.toml に集約することが業界標準となっています。

graph LR
    subgraph Modern["モダン Python 開発環境"]
        UV["uv<br/>(環境・依存関係・実行)"]
        RUFF["Ruff<br/>(リント・自動整形)"]
        TYPE["型情報・型ヒント<br/>(静的解析・安全性)"]
    end

    UV -->|快適な実行基盤| Project["堅牢で高品質な<br/>Python プロジェクト"]
    RUFF -->|品質維持| Project
    TYPE -->|不具合抑止| Project

1.4 本書で目指す開発環境のゴール

本書では、以下の目標を達成するための知識と実践手順を習得します：

uv を用いて、迷わず迅速にプロジェクトを作成・管理・実行できること。
Ruff を用いて、チーム全員で統一された美しいコードスタイルと品質基準を保てること。
Python の型ヒントを基礎から応用まで理解し、バグの少ない安全なコードを設計できること。
これらを有機的に結合し、pyproject.toml を中心とした洗練されたモダン Python 開発を実現できること。

第1章モダン Python 開発の全体像

1.1 Python 開発環境の変遷と課題

1.2 pyproject.toml による設定の一元化

1.3 現代の 3 本柱：uv、Ruff、型システム

1. 超高速パッケージマネージャー uv

2. 超高速リンター・フォーマッター Ruff

3. 静的型システムと型ヒント

1.4 本書で目指す開発環境のゴール

Keyboard shortcuts