poetry创建项目

Poetry 安装

poetry不建议安装到venv中，最好直接使用以下命令安装到python的目录中.
如果有使用pyenv安装多个python版本，可以使用pipx进行安装。

pip install poetry

Peotry创建项目

Poetry既可以在创建新项目时使用， 也可以在寄存项目中使用。

poetry创建新项目

创建新项目，可以使用以下命令

$ poetry new

创建成功后，会自动生成project name的文件夹以及以下内容

project_name
├── pyproject.toml
├── README.rst
├── poetry_demo
│ └── init.py
└── tests
├── init.py
└── test_poetry_demo.py

在既存项目中使用poetry

在项目文件夹中，使用以下命令，可直接生成 pyproject.toml文件

$ poetry init

pyproject.toml文件格式如下

name = "poetry-demo"
version = "0.1.0"
description = ""
authors = ["wenli"]

[tool.poetry.dependencies]
python = "*"

[tool.poetry.dev-dependencies]
pytest = "^3.4"

其中，
[tool.poetry.dependencies]为运行必须要使用的库。
[tool.poetry.dev-dependencies]为开发需要的库，如pytest, flake8等，无需安装也可以运行。

poetry 常用命令

添加依赖包

添加pyproject.toml中的依赖包

可以使用 install命令，直接安装pyproject.toml的依赖包。

poetry install

执行此命令之后，[tool.poetry.dependencies]和[tool.poetry.dev-dependencies]中的都会被安装。
如果只想安装dependencies中的包，可以使用如下命令。

poetry install --no-dev

添加新的依赖包

poetry add flask ：安装最新稳定版本的flask
poetry add pytest --dev : 指定为开发依赖，会写到pyproject.toml中的[tool.poetry.dev-dependencies]区域
poetry add flask=2.22.0 : 指定具体的版本
poetry install : 安装pyproject.toml文件中的全部依赖
poetry install --no-dev ： 只安装非development环境的依赖，一般部署时使用

更新所有锁定版本的依赖包
$ poetry update

更新指定依赖包

$ poetry update numpy
卸载依赖包
$ poetry remove numpy

查看可以更新的依赖
$ poetry show --outdated

查看项目安装的依赖

$ poetry show

树形结构查看项目安装的依赖

$ poetry show -t

poetry new #创建一个项目脚手架，包含基本结构、pyproject.toml 文件
poetry init #基于已有的项目代码创建 pyproject.toml 文件，支持交互式填写
poetry install #安装依赖库
poetry update #更新依赖库
poetry add #添加依赖库
poetry remove #移除依赖库
poetry show #查看具体依赖库信息，支持显示树形依赖链
poetry build #构建 tar.gz 或 wheel 包
poetry publish #发布到 PyPI
poetry run #运行脚本和代码

---

未完待续