在 Python 項目開發(fā)中，包管理、依賴管理和虛擬環(huán)境的創(chuàng)建一直是開發(fā)者們經(jīng)常面對的難題。傳統(tǒng)上，開發(fā)者通常會使用 pip、virtualenv 或者 conda 來處理這些問題。然而，隨著 Python 項目復(fù)雜度的增加，傳統(tǒng)工具往往顯得力不從心，這時 Poetry 應(yīng)運而生，成為一個更加現(xiàn)代化、簡潔和高效的工具。

本文將從零開始，帶領(lǐng)你快速上手 Poetry，介紹如何使用 Poetry 來管理 Python 項目，包括安裝、配置、依賴管理、虛擬環(huán)境和打包發(fā)布等。

什么是 Poetry？

Poetry 是一個 Python 項目的管理工具，它集成了依賴管理、虛擬環(huán)境管理、包打包、發(fā)布等功能。Poetry 旨在簡化開發(fā)者的工作流程，讓你能夠輕松地管理項目的依賴，確保環(huán)境的一致性，并快速創(chuàng)建和發(fā)布 Python 包。

Poetry 的關(guān)鍵優(yōu)勢是：

• 自動創(chuàng)建和管理虛擬環(huán)境。
• 精確的依賴解析，避免版本沖突。
• 使用 pyproject.toml 文件簡化配置和管理。
• 支持打包、發(fā)布、安裝等一體化功能。

Poetry 的安裝

首先，你需要在你的系統(tǒng)上安裝 Poetry。你可以使用官方推薦的安裝命令來進行安裝：

1. 安裝 Poetry

打開終端（命令行），并運行以下命令來安裝 Poetry：

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

或者，如果你是 Windows 用戶，你可以使用以下 PowerShell 命令：

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicP) | python -

安裝完成后，可以通過以下命令確認是否安裝成功：

poetry --version

如果安裝成功，會輸出 Poetry 的版本號。

創(chuàng)建一個新項目

Poetry 提供了一個非常簡潔的命令來初始化新的 Python 項目，它會自動創(chuàng)建必要的文件結(jié)構(gòu)和配置。

2. 創(chuàng)建新項目

在終端中運行以下命令，創(chuàng)建一個新的 Python 項目：

poetry new my_project

這將會在當前目錄下創(chuàng)建一個名為 my_project 的文件夾，并且自動生成一個基本的 Python 項目結(jié)構(gòu)。你會看到如下文件和文件夾：

my_project/
├── my_project/
│   └── __init__.py
├── pyproject.toml
└── tests/
    └── __init__.py

• pyproject.toml：這是 Poetry 項目的核心配置文件，所有關(guān)于項目的元數(shù)據(jù)（如依賴、版本等）都會寫在這個文件里。
• my_project/__init__.py：項目的 Python 源代碼文件。
• tests/：包含測試代碼的文件夾，Poetry 默認為你創(chuàng)建了一個簡單的測試文件夾。

3. 進入項目目錄

cd my_project

管理項目依賴

Poetry 提供了強大的依賴管理功能，讓你可以精確控制項目所需的包版本，并自動處理依賴的版本沖突。通過一些簡單的命令，你可以輕松地安裝、更新和管理項目依賴。

4. 初始化項目依賴

如果你已經(jīng)有一個現(xiàn)有的項目，并且希望使用 Poetry 來管理其依賴，可以通過以下命令來初始化項目并創(chuàng)建 pyproject.toml 文件：

poetry init -n

-n 參數(shù)表示自動跳過交互式提示，直接創(chuàng)建文件。這將會生成一個 pyproject.toml 文件，并為你提供一個基礎(chǔ)的依賴結(jié)構(gòu)。

5. 添加依賴

當你需要向項目中添加一個新的依賴時，可以使用 poetry add 命令。舉個例子，如果你想添加 requests 庫，可以運行以下命令：

poetry add requests

這會將 requests 庫添加到 pyproject.toml 中，同時 Poetry 會根據(jù)項目的需要自動解決依賴版本。

如果你需要添加特定版本的依賴，可以使用類似下面的命令：

poetry add requests@2.25.0

6. 安裝所有依賴

如果你從其他地方克隆了一個項目，并且需要安裝所有的依賴，可以使用 poetry install 命令。它會根據(jù) pyproject.toml 和 poetry.lock 文件安裝所有的項目依賴：

poetry install

該命令會自動創(chuàng)建并激活虛擬環(huán)境，確保你在隔離的環(huán)境中安裝依賴，從而避免全局包的沖突。

7. 安裝開發(fā)依賴

有些依賴是只在開發(fā)時需要的，比如測試框架。Poetry 允許你使用 --dev 參數(shù)來安裝開發(fā)依賴：

poetry add --dev pytest

此時，pytest 將只會在開發(fā)環(huán)境中安裝，不會影響生產(chǎn)環(huán)境的依賴。

8. 使用其他 Python 版本

Poetry 允許你指定使用特定的 Python 版本。如果你已經(jīng)安裝了多個 Python 版本，可以通過 poetry env use 命令指定 Python 解釋器的路徑。例如：

poetry env use "path/to/your/python.exe"

這個命令會強制 Poetry 使用你指定的 Python 解釋器來創(chuàng)建虛擬環(huán)境。

9. 使用 requirements.txt

如果你的項目原本使用了 requirements.txt 來管理依賴，并且你想遷移到 Poetry 上，可以使用以下命令來安裝 requirements.txt 中的所有依賴：

poetry run pip install -r requirements.txt

這會在 Poetry 的虛擬環(huán)境中使用 pip 安裝 requirements.txt 中列出的所有依賴項，并確保它們與項目的其他依賴兼容。

10. 更新依賴

隨著項目的發(fā)展，依賴可能會有新的版本發(fā)布。你可以使用 poetry update 命令來更新所有依賴到最新的兼容版本：

poetry update

這將會根據(jù)你的 pyproject.toml 文件中的版本要求，更新所有已安裝的依賴。

11. 查看項目的依賴

如果你想查看當前項目的所有依賴，可以使用：

poetry show

這將列出所有直接和間接的依賴項，并提供每個包的版本和其他詳細信息。

12. 刪除依賴

如果某個依賴不再需要，你可以使用 poetry remove 命令來刪除它：

poetry remove requests

這會將 requests 從 pyproject.toml 文件和 poetry.lock 文件中移除，并卸載它。

通過這些命令，Poetry 使得依賴管理變得更加高效和便捷。無論是添加、更新、安裝開發(fā)依賴，還是使用指定的 Python 版本，Poetry 都提供了靈活的工具來幫助你管理項目的依賴和虛擬環(huán)境。

虛擬環(huán)境管理

Poetry 自動為每個項目創(chuàng)建和管理虛擬環(huán)境，這樣就能確保你的項目始終在隔離的環(huán)境中運行，避免了全局安裝包可能帶來的沖突。

13. 查看虛擬環(huán)境

如果你想查看 Poetry 創(chuàng)建的虛擬環(huán)境，可以運行以下命令：

poetry env list

它會列出當前項目所使用的虛擬環(huán)境。你還可以通過 poetry env use 來切換 Python 版本。

14. 激活虛擬環(huán)境

你可以通過以下命令激活虛擬環(huán)境：

poetry shell

這會激活虛擬環(huán)境，并進入一個新的 shell，你可以在其中運行 Python 命令，測試代碼等。

運行項目

Poetry 允許你直接在虛擬環(huán)境中運行命令，而不需要先手動激活虛擬環(huán)境。

15. 使用 Poetry 運行命令

如果你想直接運行 Python 腳本，可以使用以下命令：

poetry run python my_project/script.py

poetry run 會確保命令在 Poetry 管理的虛擬環(huán)境中運行。

打包和發(fā)布

當你的項目開發(fā)完成后，Poetry 還可以幫助你將項目打包并發(fā)布到 PyPI 或其他 Python 包管理平臺。

16. 打包項目

首先，使用以下命令來構(gòu)建項目的發(fā)行版：

poetry build

這將會生成 .tar.gz 和 .whl 格式的包，存放在 dist/ 文件夾中。

17. 發(fā)布到 PyPI

如果你準備將項目發(fā)布到 PyPI，可以使用以下命令：

poetry publish --repository

 pypi

當然，在發(fā)布前，你需要配置 PyPI 的認證信息，可以通過 poetry config 命令進行配置。

常用 Poetry 命令總結(jié)

總結(jié)

Poetry 是一個強大的 Python 項目管理工具，它整合了依賴管理、虛擬環(huán)境、包打包和發(fā)布等多項功能。通過簡潔的命令行界面和易于理解的配置文件，它幫助開發(fā)者更高效地管理項目，并避免了版本沖突、依賴問題等常見困擾。

無論你是 Python 新手還是資深開發(fā)者，Poetry 都是一個值得嘗試的工具。通過本文的介紹，你已經(jīng)掌握了如何從零開始使用 Poetry 管理你的 Python 項目，管理依賴、虛擬環(huán)境、打包發(fā)布等都變得輕松起來。

到此這篇關(guān)于Python項目管理的利器Poetry的使用的文章就介紹到這了,更多相關(guān)Python Poetry內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論