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