Python项目管理工具Poetry使用示例详解

# 项目包的名字
name = "my-package" 
# 版本
version = "0.1.0"
# 包的描述
description = "A short description of the package."
# 许可证
license = "MIT"
# 作者
authors = ["冷冻工厂 <storyice@163.com>",]
# 维护者
maintainers = ["冷冻工厂 <storyice@163.com>",]
# READMD文件
readme = ["docs/README1.md", "docs/README2.md"]
# 包的介绍主页
homepage = "https://python-poetry.org/"
# 仓库地址
repository = "https://github.com/python-poetry/poetry"
# 文档
documentation = "https://python-poetry.org/docs/"

curl -sSL https://install.python-poetry.org | python3 -

poetry self update

poetry new project-name
# 项目名 与 文件夹名 不同
poetry new folder-name --name project-name
# 使用src项目结构（可选）
poetry new --src project-name
# 初始化已经存在的项目
cd project-name-dir
poetry init

poetry env use /full/path/to/python
# 如果解释器已经添加到环境变量中
poetry env use python3.7
poetry env use 3.7  # 同上，二选一

poetry env info

poetry env list

poetry env remove /full/path/to/python
# 同时删除多个环境
poetry env remove python3.6 python3.7 python3.8
# 一次性删除全部环境 
poetry env remove --all

poetry config virtualenvs.in-project true

# 添加依赖
poetry add <lib>
# 添加dev依赖
poetry add <lib> --dev  # poetry add package-name -D
# 删除依赖
poetry remove <lib>
# 更新依赖
poetry update
# 锁定依赖版本
poetry lock
# 列出全部依赖项
poetry show
# 列出陈旧的依赖项
poetry show --outdated
# 搜索指定的包
poetry search <name>

[tool.poetry]
name = "project-name"
version = "0.1.0"
description = ""
authors = ["Swindler <jzj@1033199817@qq.com>"]
readme = "README.md"
packages = [{include = "project_name"}]

[tool.poetry.dependencies]
python = "^3.8"
# 在此直接添加，如 0.1.0 版本的numpy
numpy = "0.1.0"

# 如果不知道指定的版本，可以用*代替，Poetry会自动选择合适的版本
numpy = "*"


[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

poetry update

>= 1.2.0
> 1
< 2
!= 1.2.3

# 将下方配置添加至pyproject.toml末尾即可
[[tool.poetry.source]]
name = "tsinghua-source"
url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
default = true  # 仅从定义仓库获取

# 将下方配置添加至pyproject.toml末尾即可
[[tool.poetry.source]]
name = "aliyun-source"
url = " http://mirrors.aliyun.com/pypi/simple/"
default = true  # 仅从定义仓库获取

poetry export -f requirements.txt --output requirements-prod.txt --without-hashes

cat requirements.txt|xargs poetry add