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