ハイパーモダンPython ―信頼性の高いワークフローを構築するモダンテクニック

5章Poetryによるプロジェクト管理

4章までは、本番品質のPythonパッケージを公開するためのビルド方法について解説しました。プロジェクト用のpyproject.tomlを作成し、uv、pip、pip-toolsを使って仮想環境を作成して、依存関係をインストールして、buildとTwineでパッケージをビルドして公開してきました。

プロジェクトのメタデータとビルドバックエンドを標準化することで、pyproject.tomlはsetuptoolsの独占状態を打破し（「Pythonプロジェクトマネージャの進化」を参照）、パッケージングエコシステムに多様性をもたらしました。Pythonパッケージの定義も簡単になりました。標準化された単一のファイルと優れたツールのサポートによって、従来のsetup.pyのボイラープレートと膨大な設定ファイルを置換できるようになりました。

しかし、依然として問題は残っています。

pyproject.tomlベースのプロジェクトで作業を始める前に、パッケージングに関するワークフロー、設定ファイル、関連ツールを調査する必要があります。また、利用可能なビルドバックエンド（表3-2）から、どれを採用するか選ばなければなりません。ただし、Pythonパッケージにおける重要な要素、例えばソースコードのレイアウトをどうするか、どのファイルがパッケージとして配布物に含まれるべきかなどは規定されていません。

依存関係や環境の管理も、もっと簡単になるかもしれません。依存関係を指定したファイルを作成し、pip-toolsでコンパイルする必要があります。そして、典型的な開発者システム上のPython環境を追跡するのは難しいでしょう。 ...