Python - poetry(3)配置项详解
config 命令
- poetry 通过 config 命令进行配置
- 也可以直接在 config.toml 文件中进行配置,该文件将在首次运行该命令时自动创建
文件目录
- macOS:~/Library/Application Support/pypoetry
- Windows: C:\Users\<username>\AppData\Roaming\pypoetry
查看当前配置列表
poetry config --list
目前就这些配置项
查看某个配置项
poetry config virtualenvs.path
修改某个配置项
poetry config virtualenvs.path /path/to/cache/directory/virtualenvs
移除某个配置项
poetry config virtualenvs.path --unset
使用环境变量
- 在使用 CI 工具时,会经常使用环境变量,这样可以不必执行 poetry config 命令
- poetry 支持环境变量,任何设置都可以使用环境变量来设置
- 环境变量必须以 poetry_ 作为前缀,大写名称组成,用 _ 下划线代替 . 和 -
栗子:virtualenvs.path
export POETRY_VIRTUALENVS_PATH=/path/to/virtualenvs/directory
配置项详解
cache-dir
poetry 使用的缓存目录的路径
默认目录路径
- macOS: ~/Library/Caches/pypoetry
- Windows: C:\Users\<username>\AppData\Local\pypoetry\Cache
- Unix: ~/.cache/pypoetry
installer.parallel
安装程序时并行执行,默认 true
virtualenvs.create
- 如果虚拟环境不存在,则会自动创建一个新的虚拟环境,默认 true
- 如果设为 false,则私用的 Python 环境必须安装且可使用 pip
virtualenvs.in-project
- 在项目的根目录中创建 virtualenv,默认 null
- 如果设置为 true,将在项目根目录中名为 .venv 的文件夹中创建 virtualenv
- 如果未显式设置(默认),poetry 将使用 .venv 目录中的 virtualenv(如果有)
- 如果设置为 false,poetry 将忽略任何现有的 .venv 目录
virtualenvs.path
在其中创建虚拟环境的目录
默认: {cache-dir}/virtualenvs
像我上面的配置就是: /Users/polo/Library/Caches/pypoetry/virtualenvs