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.toml
和 poetry.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.toml
和 poetry.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