Перейти к основному содержимому

Ruby

Плагин Ruby добавляет в OpenIDE разработку, запуск и отладку Ruby-приложений, включая Rails. Языковые возможности (автодополнение, навигация, диагностика) предоставляет сервер ruby-lsp, отладка идёт через rdbg по протоколу DAP, тесты RSpec и Minitest запускаются во встроенном тест-раннере.

Редакция: OpenIDE Pro.

Плагин: Ruby.

Проект openide-ruby-demo в OpenIDE: в редакторе task.rb с модулем TaskDesk и классом Task, слева дерево проекта с каталогами bin, db, lib и spec и панель AI Explorer, справа OpenIDE DB Client с таблицами базы task_desk_test и Docker Explorer с сервисом postgres из docker-compose.yml

Ruby-проект в OpenIDE: код в редакторе, рядом — DB-клиент и Docker Explorer.

Что поддерживается​

ВозможностьЧто есть
РедакторПодсветка .rb, .rake, .gemspec, .ru, Gemfile, Rakefile, ERB и файлов без расширения с Ruby-shebang
Автодополнение и навигацияКлассы, модули, константы и методы; переход к определению; поиск символов (Go to Class); подсказки при наведении; диагностика
ERBАвтодополнение, переход к определению и подсказки для Ruby-кода внутри <% %>
Линтеры и форматированиеRuboCop (форматирование и проверки), Reek на лету; выбор форматтера и линтера в настройках
ЗапускКонфигурация Ruby: скрипт, аргументы, параметры интерпретатора, рабочая папка, переменные окружения; запуск из контекстного меню и значок у файлов с shebang или if __FILE__ == $0
Отладкаrdbg (DAP): точки останова, шаги, переменные, вычисление выражений
ТестыRSpec и Minitest во встроенном тест-раннере; значки запуска у тестовых классов и методов; отдельный пример RSpec по номеру строки
RailsКонфигурации server, runner, произвольная команда, RAILS_ENV; Rails Minitest через bin/rails test; code lens миграций и переходов controller → view
RakeКонфигурация Rake и Инструменты → Run Rake Task… (Tools → Run Rake Task…) со списком задач
БезопасностьBrakeman и bundler-audit из меню Tools, результат в консоли
Проекты и шаблоныМастер Файл → Новый → Проект… → Ruby (File → New → Project… → Ruby): обычный проект с Gemfile или Rails с выбором базы данных, JS и CSS; шаблоны файла, класса, модуля, RSpec spec, Minitest test и spec

Мастер New Project: в списке слева выбран Ruby, справа поля Name и Location, Ruby interpreter /usr/bin/ruby с пометкой Auto-detected from PATH, Project type — Rails application, Rails version — latest, Database — SQLite, JavaScript — Import Maps, CSS — None, флажок API-only application и поле Additional arguments

Мастер нового проекта: для Rails-приложения выбираются версия Rails, база данных, JS и CSS.

Интерпретатор и окружение​

IDE определяет интерпретатор через login shell, а также из файлов .ruby-version и .tool-versions. Поддерживаются менеджеры версий rbenv, rvm, chruby, asdf и mise. Путь к интерпретатору можно задать вручную: Настройки → Языки и фреймворки → Ruby (Settings → Languages & Frameworks → Ruby).

Требования для полноценной работы:

  • Ruby 3.0 или новее для языкового сервера; для проектов на более старых версиях сервер запускается на отдельном современном Ruby;
  • гем ruby-lsp — глобально или в Gemfile;
  • гем debug — для отладки.

Если в проекте есть Gemfile без Gemfile.lock, IDE предложит выполнить bundle install. При наличии Gemfile запуск и тесты автоматически идут через bundle exec. Аддоны ruby-lsp-rails и ruby-lsp-rspec подключаются, если они есть в Gemfile.

Форматтер, линтер и набор включаемых возможностей выбираются в Ruby → Language Server; изменения применяются после перезапуска сервера. Reek включается в Ruby → Linters.

Файл board.rb в редакторе: у метода summary всплывающее замечание «Metrics/MethodLength: Method has too many lines. [11/10]» с пометкой This offense is not auto-correctable и источником RuboCop, ниже действия Disable Metrics/MethodLength for this line и More actions…

Замечание RuboCop показывается прямо в редакторе — с названием правила и быстрыми действиями.

Запуск и отладка​

Создайте конфигурацию Ruby или запустите файл из контекстного меню. В конфигурации задаются скрипт, аргументы, параметры интерпретатора, рабочая папка и переменные окружения.

Для отладки нужен гем debug. Поставьте точку останова и запустите ту же конфигурацию в режиме отладки: доступны шаги, просмотр переменных и вычисление выражений.

Отладка конфигурации task-desk: выполнение остановлено на точке останова в board.rb, на строке total = tasks.length метода summary, рядом со строкой значение total: nil. Справа скрипт task-desk с меню Run, Debug и Modify Run Configuration у значка запуска. Внизу окно Debug, вкладка Threads &amp; Variables: кадры TaskDesk::Board#summary и main, локальные переменные self, total, completed, estimated_minutes и completion_percent

Остановка на точке останова: значения переменных видны рядом с кодом и в окне Debug.

Тесты​

Рядом с классами Minitest, методами def test_* и блоками test "…" появляются значки запуска и отладки. Файл или каталог с тестами запускается из контекстного меню, отдельный пример RSpec — по номеру строки. Каталоги spec/ и test/ размечаются как тестовые; в Rails-проектах log/ и tmp/ исключаются из индексации.

Что дальше​

  • DB-клиент — база данных приложения в том же окне.
  • Docker — контейнеры для зависимостей проекта.
  • AI-агенты — Claude Code, Codex и другие агенты рядом с кодом.