安装

• custom installer

  curl -sSL https://raw.githubusercontent.com/sdispater/poetry/master/get-poetry.py | python
  source $HOME/.poetry/env  
  

• pip

  pip install poetry  # 不推荐, 可能会有冲突
  

验证安装

poetry --version

使用

• 项目初始化

• 从pipenv/pip等工具迁移

  poetry init   # 进入交互式命令行填写项目信息, 会生成pyproject.toml
  

• 添加依赖

  • 添加包

    poetry add 
    poetry add fastapi=0.38.1 -E all #  pipenv install fastapi[all]
    poetry add celery --extras "librabbitmq redis auth msgpack"  # pip install "celery[librabbitmq,redis,auth,msgpack]"
    

  • 依赖安装

    poetry install  # 会从pyproject.toml文件里读取, 如果有poetry.lock文件则会从lock文件中读取锁定依赖并安装
    

  • 虚拟环境地址

    • windows10: $User\AppData\Local\pypoetry\Cache\virtualenvs

配置

• 添加源

  修改pyproject.toml

  [[tool.poetry.source]]
  name = "tsinghua"
  url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
  verify_ssl = true
  

完整的实例

[tool.poetry]
name = "market-admin"
version = "0.1.0"
description = "market-admin is a Market background management system with fastapi"
authors = ["huangkai"]
license = "MIT"

[tool.poetry.dependencies]
python = "^3.7"
fastapi = {version = "0.38.1", extras = ["all"]}
python-dotenv = "0.10.2"
tortoise-orm = "0.13.5"
aiomysql = "0.0.20"
loguru = "^0.3.2"

[tool.poetry.dev-dependencies]
pytest = "6.2.1"
coverage = "5.3.1"

[tool.black]	# Black工具配置
target-version = ['py37']
skip-string-normalization = true

[[tool.poetry.source]]	# 源配置
name = "tsinghua"
url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
default = true

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