Налаштування

Щоб почати налаштування starship, створіть наступний файл: ~/.config/starship.toml.

mkdir -p ~/.config && touch ~/.config/starship.toml

Всі налаштування для starship виконуються в цьому TOML файлі:

# Отримання автозавершення вводу команд з config-schema.json
"$schema" = 'https://starship.rs/config-schema.json'

# Додавати порожні рядки між командними рядками
add_newline = true

# Заміняти символ '❯' в командному рядку на символ  '➜'
[character] # Назва модуля, який ми налаштовуємо – 'character'
success_symbol = '[➜](bold green)' # Частина 'success_symbol' буде використовувати символ '➜' підсвічений значенням 'bold green'

# Вимкнути модуль package, повністю приховавши його в командному рядку
[package]
disabled = true

Розташування файлу налаштувань

Ви можете змінити типове розташування файлу налаштувань за допомогою змінної середовища STARSHIP_CONFIG:

export STARSHIP_CONFIG=~/example/non/default/path/starship.toml

Так само і в PowerShell (Windows), можна додати цей рядок до $PROFILE:

$ENV:STARSHIP_CONFIG = "$HOME\example\non\default\path\starship.toml"

Або для Cmd (Windows), додайте рядок до вашого файлу starship.lua:

os.setenv('STARSHIP_CONFIG', 'C:\\Users\\user\\example\\non\\default\\path\\starship.toml')

Ведення журналу

Стандартно starship виводить попередження та інформацію про помилки у файл ~/.cache/starship/session_${STARSHIP_SESSION_KEY}.log, де ключ сесії відповідає екземпляру вашого термінала. Це, однак, може бути змінено за допомогою змінної середовища STARSHIP_CACHE:

export STARSHIP_CACHE=~/.starship/cache

Так само і в PowerShell (Windows), можна додати цей рядок до $PROFILE:

$ENV:STARSHIP_CACHE = "$HOME\AppData\Local\Temp"

Або для Cmd (Windows), додайте рядок до вашого файлу starship.lua:

os.setenv('STARSHIP_CACHE', 'C:\\Users\\user\\AppData\\Local\\Temp')

Термінологія

Модуль: Компонент командного рядка, що надає інформацію на основі контексту з вашої ОС. Наприклад, модуль "nodejs" показує версію Node.js, яка встановлена на вашому компʼютері, якщо ваша поточна тека є проєктом Node.js.

Змінна: менші субкомпоненти, що містять інформацію, що надається модулем. Наприклад, змінна "version" в модулі "nodejs" містить поточну версію Node.js.

Згідно з правилами, більшість модулів мають префікс стандартного кольору термінала (наприклад, via в "nodejs") та порожнє місце як суфікс.

Рядки

В синтаксисі TOML текстові значення оголошуються за допомогою лапок ', ", ''', or """.

Наступні символи синтаксису Starship мають спеціальне призначення у форматуванні рядків і повинні бути екрановані, якщо ви хочете показувати їх як символи: $ [ ] ( ).

Наприклад:

# літерал
format = '☺\☻ '

# звичайний рядок
format = "☺\\☻ "

# екрановані службові символи Starship
format = '\[\$\] '

При використанні символів розриву рядків можна використовувати багаторядкові оголошення. Наприклад, якщо ви хочете вивести символ $ на новий рядок, такі значення для format є еквівалентними:

# для літералів
format = '''

\$'''

# для звичайних багаторядкових рядків
format = """

\\$"""

# для звичайних рядків
format = "\n\\$"

У звичайних рядках, символ нового рядка можна використовувати наступним чином, щоб уникнути його показу.

format = """
line1\
line1\
line1
line2\
line2\
line2
"""

Формат рядків

Формат рядків це формат, з яким модуль виводить всі змінні. У більшості модулів є запис з назвою format, який налаштовує формат виводу модуля. Можна використовувати текст, змінні та текстові групи у форматуванні рядків.

Змінна

Змінна починається з символу $, за яким йде назва змінної. Назва змінною може складатись лише з літер та цифр та символу _.

Наприклад:

• '$version – це форматований рядок зі змінною з назвою version.
• $git_branch$git_commit' – рядок з двома змінними git_branch і git_commit.
• '$git_branch $git_commit' має дві змінні, розділені пробілом.

Текстова група

Текстова група складається з двох різних частин.

Перша частина, яка вкладена у квадратні дужки [] – це форматований рядок. Ви можете додати текст, змінні або навіть вкладені текстові групи.

В наступній частині, що вкладена в круглі дужки (), міститься опис стилю рядка. Ця частина використовується для стилізації першої частини.

Наприклад:

• '[on](red bold)' – виведе рядок on жирним шрифтом підсвічений червоним.
• '[⌘ $version](bold green)' – виведе символ ⌘ разом з вмістом змінної version жирним шрифтом підсвіченим зеленим.
• '[a [b](red) c](green)' – виведе a b c, де b – червона, а a та c – зелені.

Рядки стилів

Більшість модулів в starship дозволяють вам налаштовувати стилі їх виводу. Це робиться за допомогою запису (зазвичай style), який є рядком, що вказує на конфігурацію. Ось деякі приклади стилів поряд з тим, що вони роблять. За деталями щодо повного синтаксису зверніться до Довідника з розширеного налаштування.

• 'fg:green bg:blue' – зелений текст на блакитному фоні
• 'bg:blue fg:bright-green' – яскраво зелений текст на блакитному фоні
• 'bold fg:27' – жирний текст з ANSI кольором 27
• 'underline bg:#bf5700' – підкреслений текст на яскраво помаранчевому фоні
• 'bold italic fg:purple' – жирний курсив пурпурового кольору
• '' – явним чином вимикає всі стилі

Зверніть увагу, що те, як виглядатиме стиль, як буде залежати від вашого емулятора термінала. Наприклад, деякі емулятори терміналів будуть виділяти кольори замість показу жирного тексту, а також деякі кольорові теми використовують однакові значення для нормального і яскравого кольорів. Також, щоб отримати курсив, ваш термінал має містити його підтримку.

Умовне форматування

Рядок з умовним форматуванням, огорнутий в круглі дужки ( та ), не буде показуватись якщо змінні в середині не містять значень.

Наприклад:

• '(@$region)' – не буде показуватись, якщо змінна region дорівнює None чи є порожнім рядком, в іншому випадку вона буде показана разом з @, за яким йде значення регіону.
• '(якийсь текст)' ніколи не буде показуватись, через те, що немає змінних, загорнутих в дужки.
• Коли $combined є посиланням для \[$a$b\], '($combined)' не показуватиме нічого, лише якщо $a і $b одночасно містять None. Це працює так само й для '(\[$a$b\] )'.

Негативний збіг

Багато модулів мають змінні detect_extensions, detect_files та detect_folders. Вони отримують перелік рядків для порівняння, чи в них є збіги, чи – немає. Символ для перевірки "негативного збігу" (негативний збіг – те що не має мати збігу з вказаним значенням) – '!' знак оклику, вказується на початку параметра, що перевіряється. Наявність будь-якого індикатора негативного збігу в теці призведе до того, що результат роботи модуля буде перевірятись на негативний збіг.

Розширення зіставляються як із символами після останньої крапки в назві файлу, так і з символами після першої крапки в назві файлу. Наприклад, foo.bar.tar.gz буде збігатись з bar.tar.gz і gz у змінній detect_extensions. Файли, назва яких починається з крапки, взагалі не вважаються такими, що мають розширення.

Щоб побачити, як це працює на практиці, ви можете шукати збіг для файлів TypeScript, але не для MPEG Transport Stream, таким чином:

detect_extensions = ['ts', '!video.ts', '!audio.ts']

Командний рядок

Це перелік параметрів налаштувань, що використовуються для всього командного рядка.

Параметри

[!TIP] Порада Якщо у вас є символічні посилання до мережевих файлових систем, встановіть follow_symlinks у false.

Приклад

# ~/.config/starship.toml

# Використовуємо власний формат
format = '''
[┌───────────────────>](bold green)
[│](bold green)$directory$rust$package
[└─>](bold green) '''

# Чекаємо 10 мілісекунд, поки starship перевірить файли в поточній теці.
scan_timeout = 10

# Не додавати порожній рядок на початку командного рядка
add_newline = false

# Встановлює власну кольорову палітру 'foo'
palette = 'foo'

# Визначає власні кольори
[palettes.foo]
# Перевизначає наявний колір
blue = '21'
# Визначає новий колір
mustard = '#af8700'

Стандартний формат командного рядка {#default-prompt-format}

Стандартне значення змінної format використовується для визначення вигляду командного рядка, якщо вона пуста або змінна format відсутня. Стандартне значення є таким, як зазначено нижче:

format = '$all'

# Є еквівалентом до
format = """
$username\
$hostname\
$localip\
$shlvl\
$singularity\
$kubernetes\
$nats\
$directory\
$vcsh\
$fossil_branch\
$fossil_metrics\
$git_branch\
$git_commit\
$git_state\
$git_metrics\
$git_status\
$hg_branch\
$hg_state\
$pijul_channel\
$docker_context\
$package\
$bun\
$c\
$cmake\
$cobol\
$cpp\
$daml\
$dart\
$deno\
$dotnet\
$elixir\
$elm\
$erlang\
$fennel\
$fortran\
$gleam\
$golang\
$gradle\
$haskell\
$haxe\
$helm\
$java\
$julia\
$kotlin\
$lua\
$maven\
$mojo\
$nim\
$nodejs\
$ocaml\
$odin\
$opa\
$perl\
$php\
$pulumi\
$purescript\
$python\
$quarto\
$raku\
$rlang\
$red\
$ruby\
$rust\
$scala\
$solidity\
$swift\
$terraform\
$typst\
$vlang\
$vagrant\
$xmake\
$zig\
$buf\
$guix_shell\
$nix_shell\
$conda\
$pixi\
$meson\
$spack\
$memory_usage\
$aws\
$gcloud\
$openstack\
$azure\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
$cmd_duration\
$line_break\
$jobs\
$battery\
$time\
$status\
$container\
$netns\
$os\
$shell\
$character"""

Якщо ви просто хочете розширити стандартний формат, можете використовувати $all; модулі, які ви явно додали до формату, не будуть подвоєні. Напр.

# Перемістити назву теки на другий рядок
format = '$all$directory$character'

AWS

Модуль aws показує поточний регіон AWS і профіль, а також час, що залишився до кінця сесії при використанні тимчасових облікових даних. Для виводу модуль використовує змінні AWS_REGION, AWS_DEFAULT_REGION і AWS_PROFILE та файли ~/.aws/config і ~/.aws/credentials, коли треба.

Модуль показуватиме профіль якщо облікові дані знаходяться в ~/.aws/credentials або коли credential_process, sso_start_url, чи sso_session визначені в ~/.aws/config. Крім того, достатньо буде визначити будь-яку змінну AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY або AWS_SESSION_TOKEN. Якщо для параметра force_display встановлено значення true, уся доступна інформація буде показуватись, навіть якщо не буде виявлено жодних облікових даних відповідно до наведених вище умов.

Під час використання aws-vault профіль зчитується зі змінної AWS_VAULT, а дата закінчення терміну дії облікових даних зчитується зі змінної AWS_SESSION_EXPIRATION.

Під час використання awsu профіль читається зі змінної AWSU_PROFILE.

Під час використання AWSume профіль зчитується зі змінної AWSUME_PROFILE, а дата закінчення терміну дії облікових даних зчитується зі змінної AWSUME_EXPIRATION.

Під час використання saml2aws інформація про закінчення терміну дії, отримана з ~/.aws/credentials, повертається до ключа x_security_token_expires.

Під час використання aws-sso-cli профіль читається зі змінної AWS_SSO_PROFILE.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклади

Показати все

# ~/.config/starship.toml

[aws]
format = 'on [$symbol($profile )(\($region\) )]($style)'
style = 'bold blue'
symbol = '🅰 '
[aws.region_aliases]
ap-southeast-2 = 'au'
us-east-1 = 'va'
[aws.profile_aliases]
CompanyGroupFrobozzOnCallAccess = 'Frobozz'

Показати регіон

# ~/.config/starship.toml

[aws]
format = 'on [$symbol$region]($style) '
style = 'bold blue'
symbol = '🅰 '
[aws.region_aliases]
ap-southeast-2 = 'au'
us-east-1 = 'va'

Показати профіль

# ~/.config/starship.toml

[aws]
format = 'on [$symbol$profile]($style) '
style = 'bold blue'
symbol = '🅰 '
[aws.profile_aliases]
Enterprise_Naming_Scheme-voidstars = 'void**'

Azure

Модуль azure показує поточну підписку Azure. Інформація заснована на назві стандартної підписки або імені користувача, як визначено у файлі ~/.azure/azureProfile.json.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Приклади

Показ назви підписки

# ~/.config/starship.toml

[azure]
disabled = false
format = 'on [$symbol($subscription)]($style) '
symbol = '󰠅 '
style = 'blue bold'

Показ імені користувача

# ~/.config/starship.toml

[azure]
disabled = false
format = "on [$symbol($username)]($style) "
symbol = "󰠅 "
style = "blue bold"

Показ псевдонімів підписки

# ~/.config/starship.toml

[azure.subscription_aliases]
very-long-subscription-name = 'vlsn'

Battery

Модуль battery показує наскільки заряджена батарея пристрою і стан заряджання. Модуль показується лише тоді, коли заряд акумулятора пристрою нижче 10%.

Параметри

Приклад

# ~/.config/starship.toml

[battery]
full_symbol = '🔋 '
charging_symbol = '⚡️ '
discharging_symbol = '💀 '

Показ модуля Battery

Параметр конфігурації display використовується для визначення, коли має показуватись індикатор заряду батареї (threshold), який символ використовуватиметься (symbol) і як він виглядає (style). Якщо параметр display не встановлено. Стандартне значення є таким, як зазначено нижче:

[[battery.display]]
threshold = 10
style = 'bold red'

Типові значення для опції charging_symbol і discharging_symbol є відповідно типовими значеннями параметрів charging_symbol та discharging_symbol батареї.

Параметри

Параметр display є масивом з наступної таблиці.

Приклад

[[battery.display]] # стиль 'bold red' та discharging_symbol, якщо заряд між 0% та 10%
threshold = 10
style = 'bold red'

[[battery.display]] # стиль 'bold yellow' та символ 💦, якщо заряд між 10% та 30%
threshold = 30
style = 'bold yellow'
discharging_symbol = '💦'

# якщо рівень заряду понад 30%, індикатор заряду не показується

Buf

Модуль buf показує поточну встановлену версію Buf. Стандартно, модуль показується якщо поточна тека містить buf.yaml, buf.gen.yaml або конфігураційний файл buf.work.yaml.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[buf]
symbol = '🦬 '

Bun

Модуль bun показує поточну встановлену версію рушія JavaScript – bun. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл bun.lock
• Поточна тека містить файл bun.lockb
• Поточна тека містить файл bunfig.toml

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

Налаштуйте формат

# ~/.config/starship.toml

[bun]
format = 'via [🍔 $version](bold green) '

C

Модуль c показує інформацію про ваш C компілятор. Стандартно модуль буде показаний, якщо поточна тека містить файли .c чи .h.

Параметри

Змінні

Команди

Параметр commands отримує список команд для визначення версії та назви компілятора.

Кожна команда представлена списком з назви виконавчого файлу та аргументів, зазвичай ['myc', '--version']. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.

Якщо C-компілятор не підтримується цим модулем, ви можете зробити запит на GitHub.

Приклад

# ~/.config/starship.toml

[c]
format = 'via [$name $version]($style)'

CPP

Модуль cpp показує інформацію про ваш компілятор C++. Стандартно модуль буде показаний, якщо поточна тека містить файли .cpp, .hpp, або інші файли повїязані з C++.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

Команди

Параметр commands отримує список команд для визначення версії та назви компілятора.

Кожна команда представлена списком з назви виконавчого файлу та аргументів, зазвичай ['mycpp', '--version']. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.

Якщо компілятор C++ компілятор не підтримується цим модулем, ви можете зробити запит на GitHub.

Приклад

# ~/.config/starship.toml

[cpp]
disabled = false
format = 'via [$name $version]($style)'

Character

Модуль character показує символ (зазвичай стрілку) поруч з текстом, який вводиться в терміналі.

Символ підкаже вам, чи була остання команда успішною, чи ні. Це можна зробити двома способами:

• зміною кольору (red/green)
• зміною символу (❯/✖)

Стандартно відбувається зміна кольору. Якщо ви також хочете змінювати й символ, подивитися на цей приклад.

[!WARNING] Попередження vimcmd_symbol підтримується лише у cmd, fish та zsh. vimcmd_replace_one_symbol, vimcmd_replace_symbol та vimcmd_visual_symbol підтримуються лише у fish через проблеми з визначенням режиму у zsh.

Параметри

Змінні

Приклади

З власним значком помилки

# ~/.config/starship.toml

[character]
success_symbol = '[➜](bold green) '
error_symbol = '[✗](bold red) '

Без власного значка помилки

# ~/.config/starship.toml

[character]
success_symbol = '[➜](bold green) '
error_symbol = '[➜](bold red) '

Значок vim

# ~/.config/starship.toml

[character]
vimcmd_symbol = '[V](bold green) '

CMake

Модуль cmake показує поточну встановлену версію CMake. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл CMakeLists.txt
• Поточна тека містить файл CMakeCache.txt

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

COBOL / GNUCOBOL

Модуль cobol показує встановлену версію COBOL. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файли .cob або .COB
• Поточна тека містить файли .cbl або .CBL

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Command Duration – час виконання

Модуль cmd_duration показує, скільки часу виконувалась остання команда. Модуль буде показаний лише в тому випадку, якщо на виконання команди пішло понад дві секунди або більше, ніж значення змінної min_time, якщо воно задане.

[!WARNING] Попередження Не перехоплюйте trap DEBUG у Bash

Якщо ви запускаєте Starship у bash, не вмикайте DEBUG trap після запуску eval $(starship init $0), бо цей модуль не працюватиме.

Користувачі Bash, яким потрібна функція preexec, можуть використовувати фреймворк bash_preexec від rcaloras. Просто визначте масиви preexec_function і precmd_functions перед запуском eval $(starship init $0), а потім продовжуйте як зазвичай.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[cmd_duration]
min_time = 500
format = 'underwent [$duration](bold yellow)'

Conda

Модуль conda показує інформацію про поточне оточення Conda, якщо змінна $CONDA_DEFAULT_ENV встановлена.

[!TIP] Порада Це не пригнічує власний модифікатор підказки conda, ви можете виконати conda config --set changeps1 False. Якщо ви використовуєте pixi, ви можете відключити модифікатор запиту pixi, використовуючи pixi config set shell.change-ps1 false.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[conda]
format = '[$symbol$environment](dimmed green) '

Container

Модуль container показує символ та назву контейнера, коли ви перебуваєте в ньому.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[container]
format = '[$symbol \[$name\]]($style) '

Crystal

Модуль crystal показує поточну встановлену версію Crystal. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл shard.yml
• Поточна тека містить файл .cr

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[crystal]
format = 'via [✨ $version](bold blue) '

Daml

Модуль daml показує поточну версію SDK Daml, коли ви перебуваєте в кореневій теці проєкту Daml. sdk-version у файлі daml.yaml буде використовуватись, якщо значення не буде перевизначене змінною оточення DAML_SDK_VERSION. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл daml.yaml

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[daml]
format = 'via [D $version](bold bright-green) '

Dart

Модуль dart показує поточну встановлену версію Dart. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл .dart
• Поточна тека містить файл .dart_tool
• Поточна тека містить файли pubspec.yaml, pubspec.yml або pubspec.lock

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[dart]
format = 'via [🔰 $version](bold red) '

Deno

Модуль deno показує поточну встановлену версію Deno. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файли deno.json, deno.jsonc, deno.lock, mod.ts, mod.js, deps.ts чи deps.js

Параметри

Змінні

Приклад

# ~/.config/starship.toml

[deno]
format = 'via [🦕 $version](green bold) '

Directory

Модуль directory показує шлях до поточної теки, урізаючи його до трьох останніх батьківських тек. Шлях до теки також буде скорочений до кореня git-репозиторію, в якому ви перебуваєте.

Якщо використовується параметр fish_style_pwd_dir_length, замість того, щоб приховувати скорочений шлях, ви побачите скорочену назву кожної теки в залежності від числа, яке ви вказали для цього параметра.

Наприклад, маємо ~/Dev/Nix/nixpkgs/pkgs де nixpkgs є коренем репозиторію, а параметр — 1. Ви побачите ~/D/N/nixpkgs/pkgs, тоді як до цього було nixpkgs/pkgs.

Параметри

substitutions дозволяє визначити довільні заміни літеральних рядків, що зустрічаються в шляху, наприклад, довгі префікси мережі або теки розробки в Java. Зауважте, що це відключить стиль fish у PWD. Приймається масив наступних пар ключ/значення:

Використовуючи regex = true, ви можете використовувати регулярні вирази Rust у from. Наприклад, ви можете замінити кожну косу риску, окрім першої за допомогою:

substitutions = [
  { from = "^/", to = "<root>/", regex = true },
  { from = "/", to = " | " },
  { from = "^<root>", to = "/", regex = true },
]

Це замінить /var/log на / | var | log.

Старий синтаксис все ще працює, хоча він не підтримує регулярні вирази:

[directory.substitutions]
'/Volumes/network/path' = '/net'
'src/com/long/java/path' = 'mypath'

fish_style_pwd_dir_length взаємодіє зі стандартними опціями скорочення, по-перше, що може бути дивним, якщо значення не нуль, замість цього будуть показуватись компоненти шляху, які звичайно скорочені, зі вказаною кількістю символів. Наприклад, шлях /built/this/city/on/rock/and/roll, який зазвичай показуватиметься як rock/and/roll, буде показаний як /b/t/c/o/rock/and/roll з fish_style_pwd_dir_length = 1 — шлях компонентів, які зазвичай вилучаються, показуються одним символом. Для fish_style_pwd_dir_length = 2 це буде /bu/th/ci/on/rock/and/roll.

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Розгляньмо шлях /path/to/home/git_repo/src/lib

Приклад

# ~/.config/starship.toml

[directory]
truncation_length = 8
truncation_symbol = '…/'

Direnv

Модуль direnv показує статус rc-файла якщо він існує. Статус включає: шлях до файлу rc, чи він завантажений та, чи direnv дозволяє його використання.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[direnv]
disabled = false

Docker Context

Модуль docker_context показує поточний Docker context якщо його не встановлено у default чи desktop-linux, або якщо змінні середовища DOCKER_MACHINE_NAME, DOCKER_HOST або DOCKER_CONTEXT встановлені (оскільки вони призначені для перевизначення контексту).

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[docker_context]
format = 'via [🐋 $context](blue bold)'

Dotnet

Модуль dotnet показує відповідну версію .NET Core SDK для поточної теки. Якщо SDK закріплена в поточній теці, показується закріплена версія. В іншому випадку модуль покаже останню встановлену версію SDK.

Стандартно модуль буде показаний в командному рядку, коли в теці присутні один чи більше наступних файлів:

• global.json
• project.json
• Directory.Build.props
• Directory.Build.targets
• Packages.props
• *.csproj
• *.fsproj
• *.xproj

Вам також знадобиться .NET Core SDK, встановлений для того, щоб використовувати його правильно.

Всередині, цей модуль використовує власний механізм для виявлення версій. Як правило, він удвічі швидший ніж запуск dotnet --version, але він може показувати некоректну версію, якщо ваш проєкт .NET має незвичайне розташування тек. Якщо точність важливіша за швидкість, ви можете вимкнути механізм встановивши heuristic = false в налаштуваннях модуля.

Модуль також показуватиме Target Framework Monamework (https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-frameworks), коли у поточній теці є файл .csproj.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[dotnet]
symbol = '🥅 '
style = 'green'
heuristic = false

Elixir

Модуль elixir показує поточну встановлену версію Elixir та Erlang/OTP. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл mix.exs.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[elixir]
symbol = '🔮 '

Elm

Модуль elm показує поточну встановлену версію Elm. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл elm.json
• Поточна тека містить файл elm-package.json
• Поточна тека містить файл .elm-version
• Поточна тека містить файл elm-stuff
• The current directory contains .elm files

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[elm]
format = 'via [ $version](cyan bold) '

Environment Variable

Модуль env_var показує поточне значення обраних змінних середовища. Модуль показується, якщо виконується будь-яка з наступних умов:

• Параметр variable відповідає наявній змінній середовища
• Параметр variable не визначено, але є параметр default

[!TIP] Порада Порядок показу модулів env_var можна встановити індивідуально, включивши ${env_var.foo} у формат верхнього рівня format (оскільки він містить крапку, потрібно використовувати ${...}). Типово, модуль env_var покаже усі модулі env_var, в тому порядку, в якому вони були визначені.

[!TIP] Порада Кілька змінних середовища можна відобразити за допомогою .. (див. приклад) Якщо параметр конфігурації variable не задано, модуль виводитиме значення змінної під назвою тексту після символу ..

Приклад: наступна конфігурація показуватиме значення змінної середовища USER

tomlCopy

# ~/.config/starship.toml

[env_var.USER] default = 'unknown user' ```

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[env_var]
variable = 'SHELL'
default = 'unknown shell'

Показ кількох змінних оточення:

# ~/.config/starship.toml

[env_var.SHELL]
variable = 'SHELL'
default = 'unknown shell'
[env_var.USER]
default = 'unknown user'

Erlang

Модуль erlang показує поточну встановлену версію Erlang/OTP. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл rebar.config.
• Поточна тека містить файл erlang.mk.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[erlang]
format = 'via [e $version](bold red) '

Fennel

Модуль fennel показує поточну встановлену версію Fennel. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл .fnl

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[fennel]
symbol = '⫰ '

Fill

Модуль fill заповнює простір в рядку вказаним символом. Якщо використовується кілька модулів fill, вони можуть заповнювати рядок рівномірно розподіляючи його довжину між собою. Це корисно для форматування інших модулів.

Параметри

Приклад

# ~/.config/starship.toml
format = 'AA $fill BB $fill CC'

[fill]
symbol = '-'
style = 'bold green'

Створить рядок, що виглядатиме наступним чином:

AA -------------------------------------------- BB -------------------------------------------- CC

Fortran

Модуль fortran показує поточну встановлену версію Fortran.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Команди

Параметр commands отримує список команд для визначення версії та назви компілятора.

Кожна команда представлена списком з назви виконавчого файлу та аргументів, зазвичай ['myfortran', '--version']. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.

Якщо компілятор Fortran не підтримується цим модулем, ви можете зробити запит на GitHub.

Fossil Branch

Модуль fossil_branch показує назву активної гілки у вашій поточній теці.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[fossil_branch]
symbol = '🦎 '
truncation_length = 4
truncation_symbol = ''

Fossil Metrics

Модуль fossil_metrics покаже кількість доданих та видалених рядків у поточній теці. Потрібна версія Fossil не нижче v2.14 (2021-01-20).

[!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[fossil_metrics]
added_style = 'bold blue'
format = '[+$added]($added_style)/[-$deleted]($deleted_style) '

Google Cloud (gcloud)

Модуль gcloud показує поточну конфігурацію gcloud CLI. Він базується на файлі ~/.config/gcloud/active_config та на ~/.config/gcloud/configurations/config_{CONFIG NAME} і на змінній оточення CLOUDSDK_CONFIG.

Коли модуль увімкнено, він завжди буде активним, якщо не встановлено параметр detect_env_vars, в такому випадку модуль буде активним лише коли буде встановлено одну зі змінних середовища.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклади

Показувати обліковий запис та проєкт

# ~/.config/starship.toml

[gcloud]
format = 'on [$symbol$account(@$domain)(\($project\))]($style) '

Показувати тільки назву активної конфігурації

# ~/.config/starship.toml

[gcloud]
format = '[$symbol$active]($style) '
style = 'bold yellow'

Показувати обліковий запис та псевдо регіону

# ~/.config/starship.toml

[gcloud]
symbol = '️🇬️ '
[gcloud.region_aliases]
us-central1 = 'uc1'
asia-northeast1 = 'an1'

Показувати обліковий запис та псевдо проєкту

# ~/.config/starship.toml

[gcloud]
format = 'on [$symbol$account(@$domain)(\($project\))]($style) '
[gcloud.project_aliases]
very-long-project-name = 'vlpn'

Git Branch

Модуль git_branch показує активну гілку репозиторію у вашій поточній теці.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[git_branch]
symbol = '🌱 '
truncation_length = 4
truncation_symbol = ''
ignore_branches = ['master', 'main']

Git Commit

Модуль git_commit показує поточний хеш коміту, а також теґ (якщо він є) репозиторію у вашій поточній теці.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[git_commit]
commit_hash_length = 4
tag_symbol = '🔖 '

Git State

Модуль git_state показується в теках, які є частиною репозиторію git, під час виконання операцій на зразок REBASING, BISECTING тощо. Якщо є інформація про прогрес (наприклад, REBASING 3/10), ця інформація також буде показана.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[git_state]
format = '[\($state( $progress_current of $progress_total)\)]($style) '
cherry_pick = '[🍒 PICKING](bold red)'

Git Metrics

Модуль git_metrics покаже кількість доданих та видалених рядків у поточному репозиторії git.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[git_metrics]
added_style = 'bold blue'
format = '[+$added]($added_style)/[-$deleted]($deleted_style) '

Git Status

Модуль git_status показує символ, що описує стан репозиторію в поточній теці.

[!TIP] Порада Модуль Git Status працює дуже повільно у теках Windows (наприклад, у теках /mnt/c/) у середовищі WSL. Ви можете вимкнути модуль або використати windows_starship для використання Windows-версії Starship для тримання git_status для цих шляхів.

Параметри

Змінні

Наступні змінні можуть бути використані у format:

*: Ця змінна може бути використана лише як частина стилю рядка

Наступні змінні можуть бути використані у diverged:

Наступні змінні можуть використовуватись в conflicted, ahead, behind, untracked, stashed, modified, staged, renamed, deleted, typechanged, worktree_added, worktree_deleted, worktree_modified, worktree_typechanged, index_added, index_deleted, index_modified та index_typechanged:

Приклад

# ~/.config/starship.toml

[git_status]
conflicted = '🏳'
ahead = '🏎💨'
behind = '😰'
diverged = '😵'
up_to_date = '✓'
untracked = '🤷'
stashed = '📦'
modified = '📝'
staged = '[++\($count\)](green)'
renamed = '👅'
deleted = '🗑'

Показує кількість комітів ahead/behind

# ~/.config/starship.toml

[git_status]
ahead = '⇡${count}'
diverged = '⇕⇡${ahead_count}⇣${behind_count}'
behind = '⇣${count}'

Використання виконавчого файлу Windows Starship у Windows у шляхах WSL

# ~/.config/starship.toml

[git_status]
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'

Gleam

Модуль gleam показує поточну встановлену версію Gleam. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл gleam.toml
• Поточна тека містить файли з розширенням .gleam

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[gleam]
format = 'via [⭐ $version](bold red) '

Go

Модуль golang показує поточну встановлену версію Go. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл go.mod
• Поточна тека містить файл go.sum
• Поточна тека містить файл go.work
• Поточна тека містить файл glide.yaml
• Поточна тека містить файл Gopkg.yml
• Поточна тека містить файл Gopkg.lock
• Поточна тека містить файл .go-version
• Поточна тека містить теку Godeps
• Поточна тека містить файл .go

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[golang]
format = 'via [🏎💨 $version](bold cyan) '

Використання mod_version

# ~/.config/starship.toml

[golang]
format = 'via [$symbol($version )($mod_version )]($style)'

Guix-shell

Модуль guix_shell показує середовище guix-shell. Модуль буде показано, коли ви перебуваєте в середовищі guix-shell.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[guix_shell]
disabled = true
format = 'via [🐂](yellow bold) '

Gradle

Модуль gradle показує версію Gradle Wrapper що використовується в теці проєкту.

Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить теку gradle/wrapper/gradle-wrapper.properties.
• Поточна тека містить файли .gradle або .gradle.kts.

Модуль gradle може лише зчитувати версію Gradle Wrapper з вашого файлу налаштувань, ми не запускаємо на виконання вашу обгортку з міркувань безпеки.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Haskell

Модуль haskell знаходить поточну версію GHC та/або Stack snapshot.

Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл stack.yaml
• Поточна тека містить файли .hs, .cabal або .hs-boot

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Haxe

Модуль haxe показує поточну встановлену версію Haxe. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файли project.xml, Project.xml, додаток. ml, haxelib.json, hxformat.json або .haxerc
• Поточна тека містить теку .haxelib або haxe_libraries
• Поточна тека містить файли .hx або .hxml

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[haxe]
format = "via [⌘ $version](bold fg:202) "

Helm

Модуль helm показує поточну встановлену версію Helm. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл helmfile.yaml
• Поточна тека містить файл Chart.yaml

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[helm]
format = 'via [⎈ $version](bold white) '

Hostname

Модуль hostname показує назву хосту.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклади

Завжди показувати hostname

# ~/.config/starship.toml

[hostname]
ssh_only = false
format = '[$ssh_symbol](bold blue) on [$hostname](bold red) '
trim_at = '.companyname.com'
disabled = false

Приховувати hostname для віддалених сеансів tmux

# ~/.config/starship.toml

[hostname]
ssh_only = false
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
disabled = false

Замінити імʼя хосту псевдонімом

# ~/.config/starship.toml
[hostname]
aliases = { "Max's MacBook Pro" = "home" }

Java

Модуль java показує поточну встановлену версію Java. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• В поточній теці містяться файли pom.xml, build.gradle.kts, build.sbt, .java-version, deps.edn, project.clj, build.boot або .sdkmanrc
• Поточна тека містить файли з розширеннями .java, .class, .gradle, .jar, .clj або .cljc

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[java]
symbol = '🌟 '

Jobs

Модуль jobs показує поточну кількість завдань, що виконуються зараз. Модуль показуватиметься лише у випадку наявності фонових завдань. Модуль покаже кількість запущених завдань, якщо є хоча б 2 завдання, або більше за значення в number_threshold, за наявності. Модуль покаже символ, якщо є принаймні одне, чи більше за значення symbol_threshold, фонове завдання. Ви можете встановити обидва значення в 0, щоб завжди показувати символ і кількість завдань, навіть якщо виконується 0 завдань.

Стандартний функціонал:

• 0 завдань -> нічого не показується.
• 1 завдання -> показується symbol.
• 2 чи більше завдань -> показується symbol + число.

[!WARNING] Попередження Цей модуль не підтримується на tcsh.

[!WARNING] Попередження Параметр threshold є застарілим, але якщо ви хочете використовувати його, модуль покаже кількість запущених завдань, якщо їх більш ніж 1, або більше значення конфігурації threshold, якщо воно існує. Якщо threshold встановлено у 0, то модуль також показуватиметься, коли немає запущених завдань.

Параметри

*: Цей параметр застарів, використовуйте параметри number_threshold та symbol_threshold замість цього.

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклади

# ~/.config/starship.toml

[jobs]
символ = '+ '
number_threshold = 4
symbol_threshold = 0

Зміна процесу групування поведінки у fish

При використанні оболонки Fish, Starship стандартно підраховує групи завдань замість окремих ідентифікаторів процесів. Це запобігає надмірному підрахунку, коли конвеєр має кілька процесів, але тільки одну призупинену групу. Щоб повернутися до старого підрахунку на основі PID, додайте наступне до конфігурації оболонки:

set -g __starship_fish_use_job_groups "false"

Julia

Модуль julia показує поточну встановлену версію Julia. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл Project.toml
• Поточна тека містить файл Manifest.toml
• Поточна тека містить файл .jl

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[julia]
symbol = '∴ '

Kotlin

Модуль kotlin показує поточну встановлену версію Kotlin. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файли, .kt або .kts

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[kotlin]
symbol = '🅺 '

# ~/.config/starship.toml

[kotlin]
# Uses the Kotlin Compiler binary to get the installed version
kotlin_binary = 'kotlinc'

Kubernetes

Показує поточну назву Kubernetes context та, якщо встановлено, простір імен, користувача та кластер з файлу kubeconfig. Простір імен повинен бути встановлений у файлі kubeconfig файл, це можна зробити через kubectl config set-context starship-context --namespace astronaut. Так само можна встановити користувача та кластер за допомогою kubectl config set-context starship-context --user starship-user та kubectl config set-context context context context --cluster starship-cluster, відповідно. Якщо параметр $KUBECONFIG встановлено, то модуль буде використовувати його, якщо ні — ~/.kube/config.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Коли модуль увімкнено, він завжди буде активним, якщо будь-який з параметрів detect_env_vars, detect_extensions, detect_files або detect_folders встановлені, модуль буде активним тільки в теках, що відповідають умовам або якщо одна зі змінних середовища була встановлена.

Параметри

[!WARNING] Попередження Параметри context_aliases та user_aliases є застарілими. Використовуйте contexts та, відповідно, context_alias та user_alias, натомість.

*: Цей параметр є застарілими, додайте contexts, відповідно, context_alias та user_alias, натомість.

Для налаштування стилю модуля для конкретних середовищ використовуйте наступну конфігурацію як частину списку contexts:

Зверніть увагу, що всі регулярні вирази виглядають як ^<pattern>$ і мають збігатись з усім рядком. Регулярний вираз *_pattern може мати групи, які можуть зазначатись у відповідних аліасах як $name та $N (дивіться приклад нижче та документації rust Regex::replace()).

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[kubernetes]
format = 'on [⛵ ($user on )($cluster in )$context \($namespace\)](dimmed green) '
disabled = false
contexts = [
  { context_pattern = "dev.local.cluster.k8s", style = "green", symbol = "💔 " },
]

Показує модуль лише у теках, що містять файл k8s.

# ~/.config/starship.toml

[kubernetes]
disabled = false
detect_files = ['k8s']

Kubernetes Context спец налаштування

Параметр contexts використовується для налаштування того, як виглядає назва контексту Kubernetes (стиль та символ), якщо назва збігається з визначеною регулярним виразом.

# ~/.config/starship.toml

[[kubernetes.contexts]]
# стиль "bold red" + типовий символ, коли назва поточного контексту Kubernetes збігається з "production" *та* поточний користувач
# збігається з "admin_user"
context_pattern = "production"
user_pattern = "admin_user"
style = "bold red"
context_alias = "prod"
user_alias = "admin"

[[kubernetes.contexts]]
# стиль "green" + інший символ, коли назва поточного контексту Kubernetes містить openshift
context_pattern = ".*openshift.*"
style = "green"
symbol = "💔 "
context_alias = "openshift"

[[kubernetes.contexts]]
# Використання груп
# Контекст з GKE, AWS та інших хмарних постачальників зазвичай має додаткову інформацію, наприклад регіон/зону.
# Наступний елемент збігається з форматом GKE format (`gke_projectname_zone_cluster-name`)
# та змінює кожний відповідний kube context на більш зрозумілий формат (`gke-cluster-name`):
context_pattern = "gke_.*_(?P<cluster>[\\w-]+)"
context_alias = "gke-$cluster"

Line Break

Модуль line_break розділяє командний рядок на два рядки.

Параметри

Приклад

# ~/.config/starship.toml

[line_break]
disabled = true

Local IP

Модуль localip показує IPv4 адресу основного мережевого інтерфейсу.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[localip]
ssh_only = false
format = '@[$localipv4](bold red) '
disabled = false

Lua

Модуль lua показує поточну встановлену версію Lua. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл .lua-version
• Поточна тека містить теку lua
• Поточна тека містить файли з розширенням .lua

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[lua]
format = 'via [🌕 $version](bold blue) '

Maven

Модуль Maven вказує на наявність проєкту Maven у поточній теці. Якщо Maven Wrapper увімкнено, версія Maven буде отримана та показана з mvn/wrapper/maven-wrapper.properties.

Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл pom.xml.
• Поточна тека містить файл .mvn/wrapper/maven-wrapper.properties.

Якщо ви використовуєте альтернативний синтаксис POM (наприклад, pom.hocon), додайте його імʼя файлу до detect_files.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Використання памʼяті {#memory-usage}

Модуль memory_usage показує поточне використання оперативної памʼяті та памʼяті файлу підкачки.

Стандартно використання файлу підкачки показується якщо його розмір не є нульовим.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Цю змінну можна використовувати лише як частину стилю рядка **: Інформація щодо файлів SWAP показується лише у разі наявності в поточній системі

Приклад

# ~/.config/starship.toml

[memory_usage]
disabled = false
threshold = -1
symbol = ' '
style = 'bold dimmed green'

Meson

Модуль meson показує поточний стан оточення розробки Meson.

Стандартно показується назва проєкту Meson, якщо встановлено $MESON_DEVENV.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[meson]
disabled = false
truncation_symbol = '--'
symbol = ' '
style = 'bold dimmed green'

Mercurial Branch

Модуль hg_branch показує активну гілку та вершину репозиторію у вашій поточній теці.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[hg_branch]
format = 'on [🌱 $branch](bold purple)'
truncation_length = 4
truncation_symbol = ''

Mercurial State

Модуль hg_state показуватиметься в теках, які є частиною сховища mercurial, і в яких виконується операція, наприклад: REBASING, BISECTING тощо.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Mise

Модуль mise показує поточний стан mise, про який повідомляє запуск mise doctor.

[!TIP] Порада Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра disabled в false у вашому файлі налаштувань.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[mise]
health = 'ready'

Mojo

Модуль mojo показує поточну версію встановленої мови програмування Mojo

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[mojo]
format = 'via [mojo ($version )($hash )]($style)'

NATS

Модуль nats показує назву поточного контексту NATS.

Параметри

Змінні

Приклад

[nats]
format = '[$symbol]($style)'
style = 'bold purple'

Мережевий простір імен {#network-namespace}

Модуль netns показує поточний мережевий простір імен. Для отримання мережевого простору імен використовується ip netns identify, тому буде виявлено лише мережеві простори імен, змонтовані за адресою /var/run/netns.

Параметри

Змінні

Приклад

# ~/.config/starship.toml

[netns]
style = 'bold yellow'
symbol = '🌐 '

Nim

Модуль nim показує поточну встановлену версію Nim. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл nim.cfg
• Поточна тека містить файли з розширенням .nim
• Поточна тека містить файли з розширенням .nims
• Поточна тека містить файли з розширенням .nimble

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[nim]
style = 'yellow'
symbol = '🎣 '

Nix-shell

Модуль nix_shell показує середовище nix-shell. Модуль буде показано, коли ви перебуваєте в середовищі nix-shell.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[nix_shell]
disabled = true
impure_msg = '[impure shell](bold red)'
pure_msg = '[pure shell](bold green)'
unknown_msg = '[unknown shell](bold yellow)'
format = 'via [☃️ $state( \($name\))](bold blue) '

Node.js

Модуль nodejs показує поточну встановлену версію Node.js. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файл package.json
• Поточна тека містить файл .node-version
• Поточна тека містить файл .nvmrc
• Поточна тека містить теку node_modules
• Поточна тека містить файли з розширеннями .js, .mjs або .cjs
• Поточна тека містить файли з розширеннями .ts, .mts чи .cts

Додатково, модуль буде стандартно прихованим, якщо тека містить bunfig. oml, bun.lockабо bun.lockb файл, що замінює перелічені вище умови.

Параметри

Змінні

*: Ця змінна може бути використана лише як частина стилю рядка

Приклад

# ~/.config/starship.toml

[nodejs]
format = 'via [🤖 $version](bold green) '

OCaml

Модуль ocaml показує поточну встановлену версію OCaml. Типово, модуль показується, якщо виконується будь-яка з наступних умов:

• Поточна тека містить файли з розширенням .opam або теку _opam
• Поточна тека містить теку esy.lock
• Поточна тека містить файли dune або dune-project
• Поточна тека містить файли jbuild чи jbuild-ignore
• Поточна тека містить файл .merlin
• Поточна тека містить файли з розширеннями .ml, .mli, .re або .rei

Параметри

Змінні