DLToolkitDescriptionA set of extensions for VisualStudio Code to comfortable work with ruby gems:
Использование1. Goto Bean DefinitionИспользование гема RDM вводит в проект такие понятия как определение зависимости (метод #bean) и инъекция зависимости (метод #inject). Однако стандартные возможности расширения VSCODE-RUBY не позволяют быстро переходить к определению той или иной зависимости, т.к. эти методы не являются стандартными для ruby. Vscode-DLToolkit позволяет расширяет возможности плагина Vscode-Ruby, позволяя при помощи стандартного метода редактора GoToDefinition (Перейти к определению) открывать классы, содержащие определение используемой зависимости. Пример:
Переход к определению будет работать как для аргументов метода #inject, так и для использования зависимостей внутри класса. HOTKEY - cmd+(left click on service name) or F12 2. Goto Spec DefinitionТестирование- неотъемлемая часть разработки, и гем RDM подразумевает, что вы будете тестировать классы ваших пакетов. Для этого каждый пакет имеет в своей корневой директории отделенную от папки /package папку /spec. Vscode-DLToolkit знает об этом и позволяет вам быстро попадать из класса в соответствующий тест и обратно. При переходе в тест подразумевается, что файл с тестом имеет точно такой же путь относительно папки /spec, какой имеет файл с тестируемым классом относительно папки /package в корневой директории пакета. Команда умеет выполняться в 3 режимах: Режим 1: Переход между тестируемым классом и тестом Файл с тестом имеет такой же путь относительно папки /spec, как и тестируемый класс относительно папки /package. Файл с тестом содержит приставку '_spec.rb' вместо простого расширения файла. В таком случае использование плагина будет отправлять нас из теста в тестируемый класс и наоборот. Пример соответствия файлов:
Режим 2: Переход между тестируемым классом и группой тестов Иногда возникает необоходимость описать один класс группой тестов. В этом режиме при переходе из тестируемого класса в тест появляется выпадающее окно со списком тестов для данного класса. При поиске тестов подразумевается, что в папке /spec они будут лежать в папке, название которой совпадает с названием тестируемого файла. При переходе из теста работает аналогично с режимом 1. Пример соответствия файлов:
Режим 3: Создание теста для класса В том случае, если команда будет вызвана и не найдет ни папки с тестами, ни одночного теста, она выведет оповещение об этом и предложит создать одиночный тест. Если вы дадите согласие на создание нового теста, будет создан новый файл в папке /spec, в него будет вставлен шаблонный текст и редактор откроет этот файл для редактирования. HOTKEY - ctrl+cmd+R 3. Find unused and duplicated dependenciesПри использовании большого количества зависимостей внутри одного файла становится сложно следить за всем списком зависимых компонентов. Для этого каждый раз когда вы сохраняете файл с расширением .rb (за исключением _spec.rb файлов) расширение анализирует список зависимостей, находит дубликаты и зависимости, которые не используются и выводит об этом оповещение. При вызове команды, строки, содержащие эти зависимости, будут удалены. Пример: До использования расширения:
После использования расширения:
HOTKEY - ctrl+cmd+E 4. Goto PackageВ больших проектах появляется большое количество пакетов (спасибо, Кеп) и ориентироваться среди большой кучи папок становится довольно сложно. Для упрощения работы расширение дает возможность для быстрой навигации по пакетам. Команда выводит список всех пакетов во всплывающем окне. При выборе пакета выводится список всех файлов (не скрытых, т.е. название которых начинается не с точки) с возможностью открытия любого из них в новой вкладке. HOTKEY - ctrl+cmd+P 5. Show Package name in StatusBarДля того, чтобы каждый раз не искать, в каком пакете мы находимся, в левой части статус бара выводится название текущего пакета 6. Show all existing dependencies (Beans)Показывает в выпадающем окне все существующие в проекте зависимости, сгруппированные по пакетам. При выборе зависимости (bean) открывает файл с зависимостью в новой вкладке, при выборе пакета открывает главный файл внутри пакета (название файла совпадает с названием пакета) HOTKEY - ctrl+cmd+B 7. Show all used dependencies (Beans)Команда работает аналогично показу всех существующих бинов, однако разница состоит в том, что список используемых бинов ограничен используемыми зависимостями в открытом файле. Если открытого файла нету, расширение сообщит, что вы зачем-то импровизируете. А зря. HOTKEY - ctrl+cmd+I 8. Create new BeanЕсли предыдущих возможностей по поиску зависимостей вам мало и вы хотите создать свою собственную, расширение сделает это за вас. При запуске команды вам нужно будет ответить на несколько вопросов касательно конфигурации Бина (Bean), а именно:
9. Create new PackageВ случае, если отдельной зависимости вам мало и вы хотите создать целый пакет, расширение может сделать за вас всю работу. Но естественно мы будем делать ее не сами, а переложим всю работу на гем RDM. Поэтому если вы еще не установили его, то настоятельно советуем вам открыть консольку и набрать:
|