Python - poetry(3)配置項詳解

小菠蘿測試筆記發表於2021-09-14

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 

 

相關文章