Python - poetry（6）pyproject.toml 文件詳解

pyproject.toml 文件

tool.poetry 是最基本的section，然后它由多個 sections 組成

 

name

package 名字，必填

 

version

package 版本號  ，必填

 

description

package 描述  ，必填

 

license

package 許可證，可選

 

authors

package 作者，必填

 

maintainers

package 維護者，可選

 

readme

• package readme 文件，可選
• README.rst 或 README.md

 

homepage

package 項目網站的 URL，可選

 

repository

package 指向項目 repository 的 URL，可選

 

documentation

package 項目文檔的 URL，可選

 

keywords

與 package 相關的關鍵字列表（最多5個），可選

 

dependencies and dev-dependencies

默認情況下，poetry 會從 Pypi 庫中查找依賴項，只需要寫名稱、版本就行了

[tool.poetry.dependencies]
python = "^3.9"
requests = "^2.26.0"

重點：必須聲明與包兼容的python版本 python = "^3.9" 

 

使用私有存儲庫

[[tool.poetry.source]]
name = 'private'
url = 'http://example.com/simple'

 

extras

支持可選依賴項

[tool.poetry.dependencies]
# 這些軟件包是強制性的
mandatory = "^1.0"

# 可選依賴項列表，可自行選擇安裝哪些
psycopg2 = { version = "^2.7", optional = true }
mysqlclient = { version = "^1.3", optional = true }

[tool.poetry.extras]
mysql = ["mysqlclient"]
pgsql = ["psycopg2"]

 

當需要安裝可選依賴庫時

poetry install --extras "mysql pgsql"
poetry install -E mysql -E pgsql