MPS 2024.1 Help

Investigate changes in Git repository

In MPS, you can trace back all changes in your project. This helps you locate the author of any change, review the differences between file versions or commits, and safely roll back and undo changes if necessary.

Review project history

You can review all changes made to a project sources that match the specified filters. To view project history, open the Log tab of the Git tool window Alt+9. It shows all changes committed to all branches and remote repositories:

log view

In multi-repository projects, the colored stripe on the left indicates which root the selected commit belongs to (each root is marked with its own color). Hover over the colored stripe to invoke a tip that shows the root path:

root path
  • Search through the list of commits by entering full commit names or messages or their fragments, revision numbers, or regular expressions.

  • Filter the commits by branch or favorite branches, user, date, and folder (or root and folder for multi-root projects).

  • Click the Go to Hash/Branch/Tag go to icon on the toolbar or press Ctrl+F and specify a commit hash, tag or the name of a branch you want to jump to (you will be taken to the latest commit in that branch).

  • Click an arrow to jump to the next commit in a long branch:

    jump to next commit
  • Press the Left and Right keys to jump to the parent/child commit. This is especially useful if you have commits to different repositories and multiple branches all mixed in the Log tab of the Git tool window Alt+9.

For more information about the Log tab of the Git tool window Alt+9, refer to Log tab.

Review a project's snapshot at a specific revision

MPS lets you review the state of your project at a selected revision.

  1. Open the Git tool window Alt+9 and switch to the Log tab.

  2. Select a commit and choose Show Repository at Revision from the context menu.

The Repositories tool window will open containing the snapshot of your project at the selected revision.

Review the differences between two commits

MPS allows you to check which files were modified between two commits instead of having to browse the changes in each commit in between.

  • Select any two commits in the Log tab of the Git tool window Alt+9 and choose Compare Versions from the context menu.

    The Changes tool window with a list of files modified between the selected commits opens. You can view the diff for any file by clicking the Show diff icon or pressing Ctrl+D.

Review model history

You can review all changes made to a specific model, and find what exactly was modified in each revision.

  1. Select the necessary model in any view (the Project tool window, the editor, the Changes view, and so on).

  2. Select Git | Selected File | Show History from the main menu or Git | Show History from the context menu of the selection. The History tab is added to the Git tool window showing the history for the selected model and allowing you to review and compare its revisions.

  3. To identify which changes were introduced in a specific revision, select it in the list. On the right side of the panel the diff is instantly shown.

  4. Choose the MPS model viewer to visualize the diff in a way compatible with MPS.

    model history in MPS
  5. To identify which changes were introduced in the selected revision to the selected root node, select it in the list and press Ctrl+D or click the the Show diff icon button on the toolbar. The Diff Viewer will open showing what has changed in this revision.

You can use the toolbar buttons to compare the selected revision with the local version, compare classes from the selected revision, check out the selected revision, annotate the selected revision, and so on:

Item

Tooltip and Shortcut

Description

Branch

Branch filter

Click Branch and select a branch to review changes made to a file within this branch.

the Refresh button

Refresh

Click this button to refresh the current information.

the Show diff icon

Show Diff

Ctrl+D

Click this button to compare the selected revision of a file with its previous revision in the Diff Viewer.

the Show All Affected Files button

Show All Affected Files

Alt+Shift+A

Click this button to open the Paths Affected in Revision dialog, where you can view all files that were modified in the selected revision.

the Eye icon

View Options

Click to choose the amount of information you want to see in the History view. You can also select the Show Commit Timestamp option if you want MPS to show the commit timestamp instead of the time when a change was authored.

Also, select the type of info you want to see:

  • Show Details to display the commit message for the selected revision.

  • Show Diff Preview to open a diff preview for the selected revision.

the Open on GitHub button

Open on GitHub

Click this button to open the page that corresponds to the selected commit on GitHub.

Open on GitLab

Click this button to open the page that corresponds to the selected commit on GitLab.

the Resume button

Enable Git Log Indexing

Click this button to improve working with history of changes across the IDE. Indexing project repositories allows:

  • Fast log filtering and computing precise history.

  • Displaying all branches in file history.

  • Searching across history in Search Everywhere.

To disable this option, go to Settings | Version Control | Confirmation | Log.

Renaming

Renaming column

Click this column to expand it and review the history of file's renaming. Hover over the column to see the changes in the file's path.

View history for a selection

  1. In the editor, select the necessary fragment of source code or place the caret at the corresponding line.

  2. Choose Git | Current File | Show History for Selection from the main menu or Git | Show History for Selection from the context menu of the selection.

The history for the selected fragment will open in a separate window. If nothing is selected, the history will be displayed for the current line.

Review root history

Since MPS typically stores models in files with the model-per-file strategy, the history by default works for whole models. You select individual roots to show later in the dialogs that show the model history. MPS, however, offers the Show Root History option, as well. You can review all changes made to a specific root, and identify what exactly was modified in each revision.

  1. Select the necessary model in any view (the Project tool window, the editor, the Changes view, and so on).

  2. Select Git | Show Root History from the context menu. A dialog appears on the screen showing the history for the selected root node and allowing you to review and compare its revisions.

  3. To identify, which changes were introduced in a specific revision, select it in the list and press Ctrl+D or click the the Show diff icon button on the toolbar. The Diff Viewer will open showing what has changed in this revision.

Review node history

In addition to root nodes, you can also select arbitrary nodes in the editor and review the changes made to them. MPS offers the Show Node History option for this.

  1. Select the necessary model in any view (the Project tool window, the editor, the Changes view, and so on).

  2. Select Git | Show Node History from the context menu. A dialog appears on the screen showing the history for the selected node and allowing you to review and compare its revisions.

  3. To identify, which changes were introduced in a specific revision, select it in the list and press Ctrl+D or click the the Show diff icon button on the toolbar. The Diff Viewer will open showing what has changed in this revision.

Review history for directories

In addition to reviewing the history for the whole project or for a specific file, you can check which changes were made in specific folders.

  1. Select a directory or multiple directories in the Project tool window and choose Git | Show History from the context menu.

  2. A new tab is added to the Git tool window Alt+9 that shows commits filtered by the selected folders.

Review the differences between the local and a committed file version

You can check how a committed file revision is different from its local version:

  1. Open the Git tool window Alt+9 and switch to the Log tab.

  2. Select the commit you are interested in, and in the right pane select the file.

  3. Click the show diff button on the toolbar.

Review how changes were merged

MPS allows you to review how changes were merged from one branch to another, and how exactly conflicts (if any) were resolved during a merge:

  • In the Log tab of the Git tool window Alt+9, select the merge commit you are interested in.

    • If no conflicts were detected and resolved during the merge, MPS will display the corresponding message in the Changed Files pane and suggest reviewing changes that originate from both parents:

      changes from parents

      Select the required file from one of the nodes and click the Show Diff show diff icon on the toolbar or press Ctrl+D. The Diff Viewer will show a two-panel diff allowing you to compare the current version with the selected parent.

    • If conflicts occurred during the merge, the Changed Files pane will show you a list of files merged with conflicts.

      Select the required file and click the Show Diff show diff icon on the toolbar or press Ctrl+D. The Diff Viewer will show a three-panel diff allowing you to compare the current version with each of its parents, and see how exactly conflicts were resolved.

Locate code author (Annotate with Git Blame)

You can figure out who introduced which changes to a file by using VCS annotations (corresponds to git-blame). The annotated view shows detailed information for each line of code:

annotate

Annotations for lines modified in the current revision are marked with a bold type and an asterisk.

By default, different commits are highlighted with different colors (refer to Configure the amount of information shown in annotations).

From the annotations view, you can jump to:

  • The corresponding commit in the Log tab of the Git tool window Alt+9: click the annotation or hover over it and click the commit hash in the popup with detailed info.

  • The difference in lines: hover over an annotation. The IDE will highlight the line and the changes from the corresponding commit.

  • The corresponding commit on https://github.com: use the Open on GitHub context-menu option.

  • The related issue in your bug-tracking system if issue navigation is enabled: hover over an annotation and click the issue link if it's included in the commit message

Enable annotations

  • Right-click the gutter in the editor, the inspector window or in the Diff Viewer and select Annotate from the context menu.

    You can assign a custom shortcut to the Annotate command: go to the Keymap page of settings  Ctrl+Alt+S and look for Version Control Systems | Git | Annotate.

    To close annotations, right-click the gutter in the editor or in the Diff Viewer and select Close Annotations from the context menu.

Configure the amount of information shown in annotations

You can choose how much information you want to see in the annotations view.

  • Right-click the annotations gutter, choose View and select which type of information you want to see, including the revision from which this change originated, the date, the name of the author in different formats, and the commit number.

    You can also set highlighting under Colors.

Customize date format

  1. Press Ctrl+Alt+S to open settings and then select Appearance & Behavior | System Settings | Date Formats.

  2. Click the Date Time Pattern field next to VCS Annotate and specify the date format that you want to use for VCS annotations. See patterns reference.

Show the author of changes in the editor

You can configure the editor to show the author of the last change to an element (a method or a class) in inlay hints. To switch them on:

  1. Press Ctrl+Alt+S to open settings and then select Editor | Inlay Hints | Code vision.

  2. Select the Code author option.

  3. Choose the position to display the author name:

    • On top of the line (default)

    • On the right

When this option is enabled, you can click the author name hint in the editor to open the annotated view.

Hide the author of changes

To hide the names of code authors in the editor, do one of the following:

  • Open the Editor | Inlay Hints | Code vision page of settings  Ctrl+Alt+S and disable the Code author option.

  • Right-click the author name hint in the editor and select Hide `Code Vision: Code author` Inlay Hints.

Annotate a previous revision

MPS lets you annotate not only the current file revision, but also its previous revisions. The following options are available from the context menu of the annotations gutter:

  • Annotate Revision: this option is useful if you want to check what a file looked like after a particular change was committed. To do this, right-click this change and select Annotate Revision from the context menu.

  • Annotate Previous Revision: this option is useful if you find yourself in a situation when the last change in a particular line is meaningless, for example, if all that was changed is code formatting. In this case, you can check what the previous revision of the file looked like. To do this, right-click a change and select Annotate Previous Revision from the context menu.

  • Hide Revision: this option is useful to avoid seeing irrelevant or administrative changes. These are typically introduced by low-level migrations or formatting actions. When these changes affect the whole root, they create clutter in the Annotate dialog and so it may be desirable to exclude the changes from the view as well as from the ‘annotate’ column. The Hide Revision action allows you to exclude a revision from the annotation result in-place and show the result in both the editor and gutter. The excluded revisions can be restored with the opposite action Restore Hidden Revisions. Information about hidden revisions is displayed in the notification panel at the top of the editor. It is also possible to restore hidden revisions by clicking on the corresponding link in the notification panel.

  • Annotated Cells Highlighting: this option leverages the projectional nature of the MPS editor and the fact that the history of all nodes is preserved in Git for MPS models. Unlike in text-based editors it empowers you to review revisions on the per-node granularity, which is much finer grained than per-line revisions.

    Cells highlighting allows you to configure whether and how the cells in the editor should be colorized. Apart from not showing any colors in the editor, there are two options – either to mark all cells, each with the color of the revision when that cell was modified last time, or only colorize the cells that have been changed last time in the revision that your mouse is hovering over in the revisions left panel. With the cells colorized you can right-click any cell in the editor and the context menu offers you actions applicable to the revision that matches the color of the selected node. This way you can quickly investigate when and why a particular node has been modified.

  • Show Tooltip With Commit Info: this option enables a small tooltip window to pop up whenever the mouse hovers over a revision. The pop up window displays details about the corresponding commit, like the commit message and the revision number.

You can also annotate a particular file from the History view. In the History tab, select the file version you want to review, right-click the corresponding line and select Annotate from the context menu.

Watch this video to learn more on how you can benefit from using annotations:

Watch this MPS-specific video to learn about the additional superpowers that the annotations dialog gains from MPS:

Last modified: 26 May 2024