Проект toast — это удобная среда для разработки, работающая прямо в терминале. В отличие от редакторов, таких как vim или emacs, которые нужно настраивать самому, toast уже включает в себя управляемые LSP, встроенное дерево файлов, вкладки для нескольких файлов и темы. Эта утилита предназначена для разработчиков, которые хотят оставаться в терминале без лишних настроек.

Важно отметить, что проект на данный момент находится на ранней стадии разработки, поэтому не исключены ошибки и баги.

Установка

Чтобы установить toast, у тебя есть несколько вариантов:

• Homebrew (macOS):

  brew install paradise-runner/tap/toast

• Загрузка релиза: скачай zip-файл для твоей операционной системы с [страницы релизов](https://github.com/paradise-runner/toast/releases), распакуй его и помести бинарник в свой `$PATH`:

  curl -Lo toast.zip https://github.com/paradise-runner/toast/releases/latest/download/toast-darwin-arm64.zip
  unzip toast.zip
  install -m755 toast-darwin-arm64 /usr/local/bin/toast

• Сборка из исходников: потребуется Go версии 1.25.2 или выше.

  git clone https://github.com/paradise-runner/toast
  cd toast
  make build

Функции

Toast предлагает множество функций, среди которых:

• Редактирование в нескольких вкладках с индикаторами несохранённых изменений и кнопками закрытия.
• Подсветка синтаксиса с помощью tree-sitter для различных языков (Go, Python, JavaScript и др.).
• Управляемые языковые серверы для Go, Rust, Python, JavaScript и др.
• Проверка орфографии для Markdown и текстовых файлов.
• Навигация к определению с помощью удержания Ctrl и клика.
• Боковая панель дерева файлов с статусом git, действиями по созданию/удалению файлов и возможностью изменения размера.
• Поиск по проекту с помощью ripgrep.
• Предпросмотр Markdown для файлов .md, .markdown и .mdx.
• Встроенная система тем с несколькими опциями.
• Автосохранение с возможностью настройки задержки.

Использование

Для работы с toast можно использовать следующие команды:

• toast — открыть текущую директорию.
• toast path/to/dir — открыть конкретную директорию.
• toast path/to/file — открыть файл.
• toast new/file.go — открыть новый буфер файла, если родительская директория существует.
• toast --help — показать помощь.
• toast --version — показать версию.

Конфигурация

Toast читает файл конфигурации ~/.config/toast/config.json при старте. Можно настроить различные параметры, такие как темы, ширина боковой панели и режим автосохранения.

Пример конфигурационного файла:

{
  "theme": "toast-dark",
  "editor": {
    "tab_width": 4,
    "auto_indent": true,
    "trim_trailing_whitespace_on_save": true,
    "insert_final_newline_on_save": true,
    "auto_save": "auto",
    "auto_save_delay_ms": 300
  },
  "sidebar": {
    "visible": true,
    "width": 30
  }
}

Toast поддерживает переопределение сочетаний клавиш и импорт тем из VSCode, что позволяет сделать работу более личной.

Ограничения

Так как проект все еще находится на начальной стадии, возможно наличие ошибок и нетипичных поведений. Убедись, что ты используешь актуальную версию и следи за обновлениями в репозитории.

После установки и настройки, ты сможешь использовать toast как мощную среду для разработки в терминале, не отвлекаясь на лишние настройки. Надеюсь, этот обзор поможет тебе лучше понять, как начать работать с toast!