Differences Viewer for Folders
This window is displayed when you explore the differences between:
- Two local directories (a local history for folders, recent changes, or version control)
- A remote folder and its local version
This dialog lets you explore the differences and synchronize the folders you are comparing.
In this section:
|Item||Tooltip and shortcut||Description||Available for|
|Use these buttons to jump to the next/previous difference. |
When the last/first difference is hit, PyCharm suggests to press F7 /Shift+F7 once more and compare other files.
|Jump to Source |
|Click this button to open file in the editor's active tab. The caret will be placed in the same position as in the Differences Viewer.||All|
|Show diff in external tool||Click this button to invoke an external differences viewer, specified in the External Diff Tools page. |
This button only appears on the toolbar, when the check box Use external diff tool is selected in the External Diff Tools page.
|Click this button to show reference page.||All|
|Click this button to refresh the contents of the differences viewer.||All|
|Show new files on left side||Press this toggle button to have PyCharm show the items, that are present in the first of the compared directories or database objects and are missing in the second one.||All|
|Show difference||Press this toggle button to have PyCharm show items that are present in both folders or database objects but differ in contents, or timestamp, or size.||All|
|Show equals||Press this toggle button to have PyCharm show the items that are present in both directories or objects and have the same contents, or timestamp, or size, depending on the parameter for comparison specified in the Compare by drop-down list.||All|
|Show new files on right side||Press this toggle button to have PyCharm show the items, that are present in the second of the compared directories or database objects and are missing in the first one.||All|
|Compare by||In this drop-down list, select the parameter to be used for comparison. The available options are:|| Local folders|
| Synchronize Selected|
|Click this button to have PyCharm apply the specified action to the selected pair of items. Actions to be performed are shown in the * field.||All|
| Synchronize All|
|Click this button to have PyCharm apply the specified action to all the pairs of items in the list. Actions to be performed are shown in the * field.||All|
|Hide excluded files||Click this button to suppress showing files excluded from synchronization.||Local-remote folders|
|Filter||Type the filtering string (for example, file or table name). Use * wildcard to replace any number of arbitrary characters. |
Note that filter applies on pressing Enter.
|Path||These fields show the paths to the folders being compared. To change a directory, click the Browse button and specify another directory in the dialog that opens.|| Local folders|
List of items
|Name||These read-only fields show the names of files under the object specified in the Path fields.||All|
|Size||These read-only fields show the sizes of files under the folders being compared.|| Local folders|
|Date||These read-only fields show the timestamps of files under the folders being compared.|| Local folders|
|*|| The icon in this field indicates the action that will be applied to the pair of items in the current line upon clicking the Synchronize Selected or Synchronize All toolbar button. |
To change the currently selected action, click the icon.
The differences pane is displayed only for files with the same names, which exist on both sides. For the files and DB objects that exist on one side only, the contents of the selected file/DB object is displayed.
If the files have read-only status, they are not editable in the differences pane.
|Item||Tooltip and Shortcut||Description|
|Previous Difference / Next Difference Shift+F7 F7||Use these buttons to jump to the next/previous difference. |
When the last/first difference is hit, PyCharm suggests to click the arrow buttons F7/Shift+F7 once more and compare other files, depending on the Go to the next file after reaching last change option in the Differences Viewer settings.
This behavior is supported only when the Differences Viewer is invoked from the Version Control tool window.
|Compare Previous/Next File |
|Click these buttons to compare the local copy of the previous/next file with its update from the server.|
|Go To Changed File Ctrl+N||Click this button to display all changed files in a current change set (and navigate to them).|
| Jump to Source |
|Click this button to open the selected file in the active pane in the editor. The caret will be placed in the same position as in the Differences Viewer.|
|Viewer type|| Use this drop-down list to choose the desired viewer type. The side-by-side viewer has two panels; the unified viewer has one panel only. |
Both types of viewers enable you to
|Whitespace||Use this drop-down list to define how the differences viewer should treat white spaces in the text. |
|Highlighting mode||Select the way differences granularity is highlighted. |
The available options are:
|Collapse unchanged fragments||Click this button to collapse all unchanged fragments in both files. The amount of non-collapsible unchanged lines is configurable in the Diff & Merge settings page.|
|Synchronize scrolling||Click this button to simultaneously scroll both differences panes; if this button is released, each of the panes can be scrolled independently.|
|Editor settings||Click this button to invoke the list of available settings. Select or clear this options to show or hide whitespaces, line numbers and indent guides, to use or disable the use of soft wraps, and to set the highlighting level. |
These commands are also available from the context menu of the differences viewer gutter.
|Include into commit Alt+I|| This checkbox only appears if you invoke the Differences Viewer from the Commit Changes dialog with multiple changed files (all of which are deselected), and you explore the differences between them and hit the last difference in a file. |
Select this checkbox if you want to include the file you've reviewed into the commit.
|Move to Another Changelist F6|| This button only appears if you invoke the Differences Viewer from the Commit Changes dialog with multiple changed files (all of which are deselected), and you explore the differences between them and hit the last difference in a file. |
Click this icon to move the file you've reviewed to another changelist.
|Show diff in external tool||Click this button to invoke an external differences viewer, specified in the External Diff Tools settings page. |
This button only appears on the toolbar when the Use external diff tool option is enabled in the External Diff Tools settings page.
|Click this button to show the corresponding help page.|
|Ctrl+Tab||Use this keyboard shortcut to switch between the panes of the Differences viewer. The active pane has the cursor.|
|Use these chevron buttons to apply differences between panes (in case of the side-by-side viewer) or between lines (in case of the unified viewer). |
The chevron buttons can change their behavior:
This menu appears when you right-click an entry in the list of items. The commands in this menu define which action must be taken for the selected entry on clicking Synchronize Selected or Synchronize All. The selected action appears in the * column.
File comparison statuses and intended operations are shown in the column marked with an asterisk (*). To assign or change an operation, use the context menu associated with the corresponding cell. Alternatively, click the cell or press Space one or more times.
- (Enter) applies the operations to selected files.
- (Ctrl+Enter) applies the operations to all the files.