對虛擬環境和可重複性的需求

Python 專案通常依賴大量的外部函式庫和套件。隨著專案的成長和發展，管理這些依賴關係可能會變得複雜。 Python 開發的兩個關鍵面向是：

1. 虛擬環境：隔離空間，使專案依賴項與系統範圍的 Python 安裝分開。

2. 可重複性：確保專案可以輕鬆設定並在不同的機器或環境中一致地運作。

像 venv 和 pip 這樣的傳統工具長期以來一直用於這些目的，但它們通常需要多個步驟和手動幹預。這就是 Poetry 的用武之地，它提供了更精簡、更強大的解決方案。

為什麼選擇詩歌？

詩歌比傳統工具有幾個優點：

1. 簡化的工作流程：將依賴管理、打包和發布結合在一個工具中。

2. 依賴關係解析：自動解決依賴關係和潛在衝突。

3. 可重複建造：確保不同機器上的環境一致。

4. 鎖定檔案：產生鎖定檔案以對所有依賴項進行精確版本控制。

5. 專案隔離：自動建立和管理虛擬環境。

6. 直覺式指令：為常見任務提供使用者友善的 CLI。

安裝和設定 Poetry

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

安裝後，透過將以下行新增至 shell 設定檔（例如 ~/.bashrc 或 ~/.zshrc），將 Poetry 新增至您的 PATH：

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

重新啟動終端或執行 source ~/.bashrc （或適當的檔案）以套用變更。

透過運行驗證安裝：

poetry --version

為 Bash、Fish 或 Zsh 啟用 Tab 鍵補全

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 開發人員的絕佳選擇。