# Загальні утиліти Тут ви можете ознайомитись з утилітами загального призначення. ## `spaceship::exists` ``` title="Signature" spaceship::exists ``` Ця команда перевіряє, що вказана програма доступна в системі. Вона зчитує змінну PATH та шукає двійкові файли та функції. Вона повертає нульовий код виходу, якщо `command` існує і ненульовий код в іншому випадку. Ви можете використовувати цю утиліту, щоб перевірити, чи встановлено якусь програму, і виконувати дії на підставі якихось умов. Наприклад, ви можете повернути помилку та вийти або продовжити виконання сценарію. Наприклад: ```zsh # Перевірте наявність кількох команд if spaceship::exists nvm; then # отримати версію nvm elif spaceship::exists node; then # отримати версію node else return fi # Нічого не робити якщо docker не встановлено spaceship::exists docker || return ``` ## `spaceship::defined` ``` title="Signature" spaceship::defined ``` Те саме, що і [`spaceship::exists`](#spaceshipexists), але для функцій. Вона повертає нульовий код виходу, якщо `function` існує і ненульовий код в іншому випадку. Ви можете використовувати цю утиліту для перевірки, чи раніше користувач визначив функцію, чи ні. Наприклад: ```zsh # Перевірте, чи секцію визначено if spaceship::defined spaceship_section; then spaceship_section else # секцію не знайдено fi ``` ## `spaceship::is_git` Ця утиліта повертає нульовий код виходу, якщо поточна робоча тека є репозиторієм Git, і відмінним від нуля, якщо це не так. Наприклад: ```zsh # Вихід якщо поточна тека не є репозиторієм git spaceship::is_git || return ``` ## `spaceship::is_hg` Те саме, що і [`spaceship::is_git`](#spaceshipisgit), але для репозиторіїв Mercurial. Ця утиліта повертає нульовий код виходу, якщо поточна робоча тека є репозиторієм Mercurial, і відмінним від нуля, якщо це не так. ```zsh # Вихід якщо поточна тека не є репозиторієм Mercurial spaceship::is_hg || return ``` ## `spaceship::is_section_async` Перевіряє, чи є секція є асинхронною, чи ні шляхом перевірки параметра `SPACESHIP_
_ASYNC`. Ця утиліта повертає нульовий код виходу, якщо секція є асинхронною, і відмінним від нуля, якщо це не так. Якщо `SPACESHIP_PROMPT_ASYNC` встановлено у `false`, тоді всі секції вважаються синхронними. ``` title="Signature" spaceship::is_section_async
``` 1. `section` _Обовʼязково_ — секція, яку потрібно перевірити. Деякі секції завжди синхронні, незважаючи ні на що, щоб забезпечити коректну роботу командного рядка. Це: `user`, `dir`, `host`, `exec_time`, `async`, `line_sep`, `jobs`, `exit_code` та `char`. ## `spaceship::is_prompt_async` Перевіряє, чи командний рядок працює в асинхронному режимі. Ця утиліта повертає нульовий код виходу, якщо командний рядок працює в асинхроннім режимі, і відмінним від нуля, якщо це не так. Перевіряє, чи `SPACESHIP_PROMPT_ASYNC` встановлено у `true` і [`zsh-async` завантажується](/api/environment/#asynchronous-runtime). ## `spaceship::deprecated` Ця утиліта перевіряє, чи `option` встановлено і якщо так, виводить `message`. `message` підтримує esc-послідовності для встановлення кольору тексту, фону та інших візуальних ефектів. ``` title="Signature" spaceship::deprecated