[[416484]]

大家好，我是明哥。

之前在介紹一些管理 Python 虛擬環(huán)境的工具時，比如 pipenv，virtualenv 等，總有讀者留言，希望我整一期 poetry 的。

在接觸 poetry 之前，我以為 pipenv 已經(jīng)是我心目中最理想的虛擬環(huán)境工具，直到 19年 看過@李輝 的一篇文章(http://greyli.com/do-not-use-pipenv/)才讓我開始動搖，原來一直輕量使用的我，一直沒有感覺到 pipenv 的各種問題，咱也不知道經(jīng)過這幾年的發(fā)展，pipenv 是否有所改進?不過我想對于曾經(jīng) "深受其害" 的用戶來說，可能早就投入了 poetry 的懷抱。

廢話不多說，直接上干貨。

# 1. 安裝 poetry

poetry提供多種安裝方式，個人推薦從以下2種方式中選擇：

方式一：(推薦)使用在線腳本進行安裝，是最為推薦的安裝方式

$ curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python 

方式二：(pip) 官方不建議這么做，因為有可能會造成依賴沖突，可以考慮用 pipx 或 pipsi

$ pip install --user poetry 

安裝后，可以使用如下命令檢測是否可用

$ poetry --version 
Poetry version 1.1.4 

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

如果你是在一個已有的項目里使用 Poetry，你只需要執(zhí)行 poetry init 命令來創(chuàng)建一個 pyproject.toml 文件：

$ poetry init 

而如果是新建 一個項目，可以使用這個命令

$ poetry new demo-priject 

運行完后，在當前目錄下就會多一個 demo-project 的目錄，這個目錄下的文件結(jié)構(gòu)如下

$ tree demo-priject 
demo-priject 
├── README.rst 
├── demo_priject 
│   └── __init__.py 
├── pyproject.toml 
└── tests 
    ├── __init__.py 
    └── test_demo_priject.py 

如果要把項目代碼放入到 src 目錄下，在創(chuàng)建項目時，可以加上 --src 參數(shù)。

# 3. 創(chuàng)建虛擬環(huán)境

使用 poetry install 命令創(chuàng)建虛擬環(huán)境(確保當前目錄有 pyproject.toml 文件)：

$ poetry install 

這個命令會讀取 pyproject.toml 中的所有依賴(包括開發(fā)依賴)并安裝，如果不想安裝開發(fā)依賴，可以附加 --no-dev 選項。如果項目根目錄有 poetry.lock 文件，會安裝這個文件中列出的鎖定版本的依賴。如果執(zhí)行 add/remove 命令的時候沒有檢測到虛擬環(huán)境，也會為當前目錄自動創(chuàng)建虛擬環(huán)境。

# 4. 使用虛擬環(huán)境

創(chuàng)建虛擬環(huán)境后，如果想要在虛擬環(huán)境下執(zhí)行命令，比如去執(zhí)行腳本，去使用 pip list 等等。

可以在項目目錄下，使用如下命令

$ poetry run <commands> 

比如我查看該虛擬環(huán)境中安裝了哪些包

$ poetry run pip list 

再比如我想在該虛擬環(huán)境下執(zhí)行 app.py

$ poetry run python app.py 

每次在虛擬環(huán)境下做點啥事，命令前面都要加上 poetry run，有點太麻煩了。

這時可以使用下面這條命令，直接激活當前的虛擬環(huán)境

$ poetry shell 

# 5. 包的管理

安裝包

$ poetry add <pkg> 

添加 --dev 參數(shù)可以指定為開發(fā)依賴

$ poetry add pytest --dev 

查看所有安裝的依賴包

$ poetry show 

加上 --tree 可以查看他們的依賴關(guān)系

$ poetry show --tree 

加上 --outdated 可以查看可以更新的依賴

$ poetry show --outdated 

如果要更新依賴可以執(zhí)行這個命令

# 更新全部 
$ poetry update 
 
# 更新某個依賴 
$ poetry update foo 

想卸載某個包，用這個命令

$ poetry remove foo 

# 6. 常用配置

Poetry 的配置存儲在單獨的文件中，比 Pipenv 設置環(huán)境變量的方式要方便一點。配置通過 poetry config 命令設置，比如下面的命令可以寫入 PyPI 的賬號密碼信息：

$ poetry config http-basic.pypi username password 

下面的命令設置在項目內(nèi)創(chuàng)建虛擬環(huán)境文件夾：

$ poetry config settings.virtualenvs.in-project true 

另一個常用的配置是設置 PyPI 鏡像源，以使用豆瓣提供的 PyPI 鏡像源為例，你需要在 pyproject.toml 文件里加入這部分內(nèi)容：

[[tool.poetry.source]] 
name = "douban" 
url = "https://pypi.doubanio.com/simple/"