oh-my-posh/docs/docs/segment-python.md
2021-12-03 22:01:44 +01:00

2 KiB

id title sidebar_label
python Python Python

What

Display the currently active python version and virtualenv. Supports conda, virtualenv and pyenv.

Sample Configuration

{
  "type": "python",
  "style": "powerline",
  "powerline_symbol": "\uE0B0",
  "foreground": "#100e23",
  "background": "#906cff",
  "properties": {
    "prefix": " \uE235 "
  }
}

Properties

  • home_enabled: boolean - display the segment in the HOME folder or not - defaults to false
  • display_virtual_env: boolean - show the name of the virtualenv or not - defaults to true
  • display_default: boolean - show the name of the virtualenv when it's default (system, base) or not - defaults to true
  • display_version: boolean - display the python version - defaults to true
  • display_error: boolean - show the error context when failing to retrieve the version information - defaults to true
  • missing_command_text: string - text to display when the command is missing - defaults to empty
  • display_mode: string - determines when the segment is displayed
    • always: the segment is always displayed
    • files: the segment is only displayed when *.py, *.ipynb, pyproject.toml, venv.bak, venv, or .venv files are present (default)
    • environment: the segment is only displayed when a virtual env is present
    • context: the segment is only displayed when either environment or files is active
  • template: string - A go text/template template extended with sprig utilizing the properties below. Defaults to {{ .Full }}

Template Properties

  • .Full: string - the full version
  • .Major: string - is the major version
  • .Minor: string - is the minor version
  • .Patch: string - is the patch version
  • .Prerelease: string - is the prerelease version
  • .BuildMetadata: string - is the build metadata