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