Poetry
介绍
曾经有一段时间想用 pipenv ，但后来因种种原因放弃了，后面就一直使用 requirements.txt，
直到最近用了 pyproject.toml + flit 的方案，但总是感觉不太好，不如 cargo pnpm 之类的工具用得爽。
最近在同事的介绍下，尝试了下 poetry，感觉真是挺好的，pycharm也支持得很好。
和 cargo 一样好用了。
安装
pipx
建议使用 pipx 安装，那 pipx 要怎么安装呢。
在linux上 pipx 只需要 apt install 下就可以了。Windows上需要用scoop来安装， scoop虽然很好，但是安装时需要科学上网。如果有困难，也可以使用uv来安装poetry。
使用pipx安装完成后，记得用 pipx ensurepath 将 poetry的路径加到PATH中。
uv
uv这个工具也不错，可以用来替代 pyenv, pipx, venv/poetry/pipenv，管理虚拟环境时，不如poetry好，lock的时候检查时没有poetry全。 uv由rust编写，就是一个单独的exe，可以直接从github release下载。下载完成后， 需要配置镜像，新建 $env:AppData\Roaming\uv\uv.toml 文件，内容如下：
[[index]]
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
default = true
配置好后，就可以使用 uv tool install poetry 或 uv tool install --with poetry-plugin-pypi-mirror poetry 安装了。
使用uv安装完成后，记得用 uv tool update-shell 将 poetry 的路径加到PATH中。
配置
- 查看当前配置：
poetry config --list 将默认的venv的路径设置到工程根目录中的(放在外面还是好一点，省得搜索时总搜到这里的代码).venv：poetry config virtualenvs.in-project true- 如果C盘空间不足，可以将cache设置到D盘：
poetry config cache-dir D:/.poetry
常用命令
- 新建工程：
poetry new xxx - 在已有工程中添加：
poetry init - 使用指定的python（官方）：
poetry env use /full/path/to/python - 添加依赖：
poetry add <dep> - 添加dev依赖：
poetry add <dep> -G dev - 添加某个平台的依赖：
poetry add <dep> --platform win32 - 删除依赖：
poetry remove <dep> - 手动修改了
pyproject.toml后，更新poetry.lock文件：poetry lock --no-update，注意--no-update否则会所有依赖都更新了 - 安装依赖：
poetry install - 只安装运行时依赖：
poetry install --only main
extras
poetry对extras支持得并不是很好，本以为group会自动映射成extras，但实际并不是这样。group只能被poetry安装，extras是pip安装时要的东西，
需要将某个package设置为optional，例如 pygit2 = { version = "^1.16.0", optional = true }
然后添加
[tool.poetry.extras]
extra_name = ["pygit2", "other-package"]
默认poetry install时还不会安装，需要手动安装，例如 poetry install --extras extra_name 或者 poetry install --all-extras
export to requirements.txt
poetry可以导出为requirements.txt（官方文档），然后就可以用pip安装了。
poetry export -f requirements.txt --output requirements.txt
添加pypi镜像
如果只是为本工程添加镜像，可以 pyproject.toml 添加如下行
[[tool.poetry.source]]
name = "tsinghua"
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
priority = "primary"
但是全局就没有那么友好了。还得装个插件，按插件说明
pipx inject poetry poetry-plugin-pypi-mirror
手动打开poetry用户配置文件，注意，没法使用poetry config命令，用户配置文件在这里
notepad $env:APPDATA\pypoetry\config.toml
在打开的文件中添加
[plugins]
[plugins.pypi_mirror]
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"