Python新建Poetry 環境

惊蛰星辰發表於2024-05-31

1、安裝 Poetry:

如果您還沒有安裝 Poetry,可以透過以下命令安裝它:

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

指定虛擬環境存放目錄

poetry config virtualenvs.path D:\WorkSpace\Venv

2、建立新的 Poetry 專案:

安裝 Poetry 後,您可以使用 poetry new 命令來建立一個新專案。開啟您的終端或命令提示符,然後導航到您想要建立專案的目錄,並執行以下命令:

poetry new my-project

其中 my-project 是您想要建立的專案的名稱。這個命令會建立一個名為 my-project 的新目錄,並在其中生成一個基本的 Poetry 專案結構。
您可以使用 --path 或 -p 選項來指定一個特定的目錄。

poetry new my-project

如果是已有專案轉為使用poetry作為依賴管理,可以進行初始化

poetry init

3、啟用虛擬環境:

在專案建立後,您需要啟用 Poetry 建立的虛擬環境。在專案根目錄中執行以下命令:

poetry install

這個命令會安裝 pyproject.toml 中定義的所有依賴項,並啟用虛擬環境。

4、使用虛擬環境:

一旦虛擬環境被啟用,您可以開始使用您的專案了。例如,您可以使用以下命令來執行一個簡單的 Python 指令碼:

poetry run python my_script.py

或者,如果您想要使用互動式 Python 直譯器:

poetry shell

這會將您帶入一個 shell 會話,其中已經啟用了 Poetry 的虛擬環境。在這個會話中,您可以執行 Python 命令和指令碼,而無需手動啟用環境。

5、管理依賴項:

如果您需要新增或更新依賴項,可以使用 poetry add 命令:

poetry add requests

這會將 requests 庫新增到您的專案中,並自動更新 pyproject.tomlpoetry.lock 檔案。
如果你想指定安裝的資料來源可以在pyproject.toml檔案中新增下面程式碼:

[[tool.poetry.source]]
name = "tuna"
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true

如果你想從requirements.txt 管理依賴改為使用poetry管理,

可以使用 PowerShell 指令碼讀取 requirements.txt 並將依賴項新增到 Poetry 專案中:

Get-Content requirements.txt | ForEach-Object { poetry add $_ }

6、安裝依賴:

如果您還沒有安裝專案中的所有依賴項,可以使用 poetry install 命令來安裝它們:

poetry install

這將根據 pyproject.tomlpoetry.lock 檔案中的資訊安裝所有依賴項。

7、更新依賴:

使用 Poetry 的 update 命令來更新專案中的依賴項。例如,如果您想要更新所有依賴項,可以使用以下命令:

poetry update

如果您只想更新特定的依賴項,可以使用以下命令:

poetry update requests

請注意,如果您的專案中存在鎖檔案(poetry.lock),Poetry 可能會跳過依賴更新,因為鎖檔案中已經定義了依賴的版本。在這種情況下,您需要先刪除鎖檔案,然後再執行 update 命令。

rm -f poetry.lock
poetry update

8、檢視已安裝的依賴:

要檢視專案中已安裝的依賴項,可以使用 poetry show 命令:

poetry show

這將顯示專案中所有已安裝的依賴項及其版本。

9、檢視環境資訊:

您可以使用以下命令來檢視當前啟用的環境資訊:

poetry env info

相關文章