仮想環境と再現性の必要性

Python プロジェクトは多くの場合、多数の外部ライブラリやパッケージに依存します。プロジェクトが成長し、進化するにつれて、これらの依存関係の管理が複雑になる可能性があります。 Python 開発の 2 つの重要な側面は次のとおりです:

1. 仮想環境: プロジェクトの依存関係をシステム全体の Python インストールから分離した隔離されたスペース。

2. 再現性: プロジェクトを簡単にセットアップし、さまざまなマシンや環境間で一貫して実行できるようにします。

これらの目的には venv や pip などの従来のツールが長年使用されてきましたが、多くの場合、複数の手順と手動介入が必要になります。ここで Poetry が登場し、より合理化された堅牢なソリューションを提供します。

なぜ詩を選ぶのか？

詩には従来のツールに比べていくつかの利点があります:

1. 簡素化されたワークフロー: 依存関係の管理、パッケージ化、公開を 1 つのツールに統合します。

2. 依存関係の解決: 依存関係と潜在的な競合を自動的に解決します。

3. 再現可能なビルド: さまざまなマシン間で一貫した環境を確保します。

4. ロック ファイル: すべての依存関係の正確なバージョン管理のためのロック ファイルを生成します。

5. プロジェクトの分離: 仮想環境を自動的に作成および管理します。

6. 直感的なコマンド: 一般的なタスクに使いやすい CLI を提供します。

Poetry のインストールとセットアップ

curl -sSL https://install.python-poetry.org | python3 -

インストール後、次の行をシェル構成ファイル (~/.bashrc または ~/.zshrc) に追加して、PATH に Poetry を追加します。

export PATH="$HOME/.local/bin:$PATH"

ターミナルを再起動するか、source ~/.bashrc (または適切なファイル) を実行して、変更を適用します。

次を実行してインストールを確認します:

poetry --version

Bash、Fish、または Zsh のタブ補完を有効にする

poetry は、Bash、Fish、Zsh の補完スクリプトの生成をサポートしています。

バッシュ

poetry completions bash >> ~/.bash_completion

魚

poetry completions fish > ~/.config/fish/completions/poetry.fish

ズシュ

poetry completions zsh > ~/.zfunc/_poetry

詩を使う

新しいプロジェクトの作成

Poetry を使用して新しい Python プロジェクトを作成するには:

poetry new my-project
cd my-project

これにより、pyproject.toml ファイルを含む、基本的なプロジェクト構造を持つ新しいディレクトリが作成されます。

依存関係の追加

新しい依存関係を追加するには:

poetry add requests

これにより、パッケージが pyproject.toml ファイルに追加され、仮想環境にインストールされます。

依存関係の管理

インストールされているパッケージの表示:

poetry show

すべてのパッケージを更新:

poetry update

パッケージを削除します:

poetry remove requests

スクリプトの実行

プロジェクトの仮想環境内で Python スクリプトを実行します:

poetry run python your_script.py

仮想環境の管理

仮想環境をアクティブ化します:

poetry shell

無効化:

exit

構築と公開

プロジェクトをビルドします:

poetry build

PyPI に公開:

poetry publish

エクスポート要件

requirements.txt ファイルを生成します:

poetry export -f requirements.txt --output requirements.txt

結論

Poetry は、依存関係管理、仮想環境、パッケージ化のための統合ツールを提供することで、Python プロジェクト管理を簡素化します。その直感的なインターフェイスと強力な機能により、ワークフローを合理化し、プロジェクトの再現性を確保したいと考えている Python 開発者にとって、優れた選択肢となります。