RubyMine 2016.2 Help

Tutorial: Creating and Applying Live Templates (Code Snippets)

In this section:

What this tutorial is about ?

RubyMine comes with quite a bit of the various live templates... There are several pre-defined live template for Ruby. This tutorial aims to walk you through creating a live template for a Ruby class declaration, and using this live template.

Ruby programming is out of scope of this tutorial. Refer to the Ruby documentation for details.

The basics and usage of live templates are also not discussed here. You can find all the necessary information about the types, abbreviations, variables and storage of the live templates in the section Live Templates; to learn how to use the live templates, refer to the section Creating Code Constructs by Live Templates.

Prerequisites

Make sure that you are working with RubyMine version 8.0 or higher. If you still do not have RubyMine, download it from this page. To install RubyMine, follow the instructions, depending on your platform.

This tutorial has been created using RubyMine version 2016.1.

Creating a live template of your own

1. Creating a stub live template

  • Open the Settings/Preferences dialog (settings on the main toolbar, or Ctrl+Alt+S), expand the Editor node, and click Live Templates:
    rm_live_template_settings
  • Click add. First, choose Template Group... and specify its name (in our case, it is user). The created group gets the focus.
  • Click add again. This time, choose Live Template. The new template appears in the group that holds the focus, namely user.

What happens next?

  • First, under the group user, there is a stub live template that by now is called <abbreviation>.
  • Second, the fields for entering the template abbreviation, description, body text, and context appear:
rm_live_template_settings1

2. Defining template abbreviation and context

So, let's enter the template abbreviation. In our example, we'll type the word class in the field Abbreviation, and then enter description (which is optional, but nevertheless...).

Next, let's select the context where the new template will apply. By now, you see that the context is not defined - so click the link Define, and select the context (in our case, this is Ruby). In the future, when the context is already defined, the link changes to Change.

rm_live_template_settings2

The expansion key will be Tab, as specified by default.

3. Defining template text

Type the following code in the field Template text:

class $class$ #$doc$ end #Constructor for $class$ $name$=$class$.new()

The portions of a template text enclosed in $ signs are the template variables. You can easily tell them from the entire template text, since they stand out with color:

rm_live_template_settings4

These template variables are void yet, so let's define them first... All, except one (wait a bit to learn why).

4. Editing template variables

Click the button Edit variables:

rm_live_template_settings3

In the dialog box Edit template variables, you see the list of all (but one!) variables:

rm_live_template_settings5

Side note about $END$

You have already noticed that the template variable $END$ was not suggested for editing. This is because the template variable $END$ is predefined, and thus NOT EDITABLE. It always stands for the position of the cursor after the template expansion and filling in all the required fields. So in our case, the cursor will rest at the end of the new class declaration.

5. Memorising the new live template

You only have to click OK in the Settings/Preferences dialog. The new live template (or a code snippet) that expands into a stub Ruby class is ready. Let's just put it to a test...

Using a live template of your own

First, create a Ruby file (Alt+Insert - Ruby file), and call it sample.rb.

The new Ruby file opens for editing. Next, let's create a class declaration in it. To do that, type the template abbreviation class.

Wow... our new live template is now in the suggestion list - you can tell it by description that we've typed just in case:

rm_live_template_result

Press Tab to choose this option.

As expected, the abbreviation expands into a stub Ruby class. The red line marks the next entry point: when you type in the class name (variable class), it will be entered in this particular location.

Note, by the way, that the variable class has been used more than once - in the class declaration, in the comment for the class constructor , in the constructor itself . In these cases , the field for class has been filled in automatically.

Having typed the class name, press Enter, and see that the red line (frame) moves to the next field. Thus, you have to fill in all the required fields, and press Enter at the end.

rm_live_template_result1

See Also

Procedures:

Reference:

Last modified: 21 July 2016