跳转到主内容

Python

非官方测试版翻译

本页面由 PageTurner AI 翻译(测试版)。未经项目官方认可。 发现错误? 报告问题 →

功能

显示当前激活的 Python 版本和 virtualenv 环境。 支持 conda、virtualenv 和 pyenv(当 python 指向 pyenv shim 时)。

示例配置

{
"type": "python",
"style": "powerline",
"powerline_symbol": "",
"foreground": "#ffd43b",
"background": "#306998",
"template": "  {{ .Full }} "
}

选项

NameTypeDefaultDescription
home_enabledbooleanfalsedisplay the segment in the HOME folder or not
fetch_virtual_envbooleantruefetch the name of the virtualenv or not
display_defaultbooleantrueshow the name of the virtualenv when it's default (system, base) or not
fetch_versionbooleantruefetch the python version
cache_durationstringnonethe duration for which the version will be cached. The duration is a string in the format 1h2m3s and is parsed using the time.ParseDuration function from the Go standard library. To disable the cache, use none
missing_command_textstringtext to display when the command is missing
display_modestringenvironment
  • always: the segment is always displayed
  • files: the segment is only displayed when file extensions listed are present
  • environment: the segment is only displayed when in a virtual environment
  • context: displays the segment when the environment or files is active
version_url_templatestringa go text/template template that creates the URL of the version info / release notes
extensions[]string*.py, *.ipynb, pyproject.toml, venv.bakallows to override the default list of file extensions to validate
folders[]string.venv, venv, virtualenv, venv-win, pyenv-winallows to override the list of folder names to validate
tooling[]stringpyenv, python, python3, pythe tooling to use for fetching the version. Available options: pyenv, python, python3, py, uv
folder_name_fallbackbooleantrueinstead of default_venv_names (case sensitive), use the parent folder name as the virtual environment's name or not
default_venv_names[]string.venv, venvallows to override the list of environment's name replaced when folder_name_fallback is true

模板 (信息)

默认模板
 {{ if .Error }}{{ .Error }}{{ else }}{{ if .Venv }}{{ .Venv }} {{ end }}{{ .Full }}{{ end }}

属性

NameTypeDescription
.Venvstringthe virtual environment name (if present)
.Fullstringthe full version
.Majorstringmajor number
.Minorstringminor number
.Patchstringpatch number
.URLstringURL of the version info / release notes
.Errorstringerror encountered when fetching the version string