PyCharm 2021.1 Help

Create live templates

The following example procedure illustrates how to create a template for a TODO comment with the current date and user name.

  1. Press Ctrl+Alt+S to open IDE settings and select Editor | Live Templates.

  2. Select the template group where you want to create a new live template (for example, other).

    If you do not select a template group, the live template will be added to the user group.

  3. Click the Add button and select Live Template.

  4. In the Abbreviation field, specify the characters that will be used to expand the template. For example: todo. You can also define the languages to apply the newly added template.

    Adding a todo template
  5. (Optional) In the Description field, describe the template for reference in the future.

    For example: Insert TODO comment with the current date and username

  6. In the Template text field, specify the body of the template with variables.

    For example: # TODO $DATE$ $USER$: $END$

  7. Click Edit variables to define the variables using functions:

    NameExpressionDefault valueSkip if defined
    DATEdate()NoneYes
    USERuser()NoneYes

    You can set a default value for cases when the expression fails to evaluate, although these particular functions should always return a valid value. You can also disable the Skip if defined option for a variable to highlight the expanded value and let the user modify it if necessary.

    Editing template variables
  8. Apply all your changes.

  9. In the editor, type todo and press Tab.

    Depending on the current system date and username, the template should expand to something like:

    # TODO 09/02/2021 jetbrains:
    Using the template

Create a new template from a fragment of code

  1. In the editor, select the text fragment to create a live template from.

  2. Select Tools | Save as Live Template from the main menu. The list of the live templates opens. In this list, the newly created template has been added to the user group.

  3. Specify an abbreviation for the template, an optional description (to identify what the template is for) and modify the template body. If the template has variables defined, click Edit Variables to configure them.

  4. Click OK to apply the changes.

Copy an existing template

If you want to reuse the same template in multiple groups, or you want to create a new template based on another one, you can duplicate an existing template.

  1. On the Editor | Live Templates page of the Settings/Preferences dialog Ctrl+Alt+S, select the template you want to copy.

  2. Click Duplicate The Duplicate button on the toolbar. A new template item is added to the same group as the original, and selected.

  3. Specify a new abbreviation for the template, an optional description (to identify what the template is for), and modify the template body if necessary. If the template has variables defined, click Edit Variables to configure them.

  4. Click OK to apply the changes.

Last modified: 13 May 2021