This window is displayed every time you explore differences between:
- Two local directories (local history for folders, recent changes, or version control).
- A remote folder and its local version.
- Two database objects (data sources, schemas, tables or columns).
In this dialog box, explore the detected differences and synchronize the compared items.
You can also open the difference viewer without running PyCharm. This is done through the following command:
<path to PyCharm executable file> diff <path_1> <path_2>
where path_1
and path_2
are paths to the folders in question.
In this section:
Toolbar
Item | Tooltip and shortcut | Description | Available for |
---|---|---|---|
![]() ![]() |
F7 Shift+F7 | 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. This feature becomes available only when the Differences Viewer is invoked from the Version Control tool window. | Version control |
![]() | Jump to Source
F4 | 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. | All |
![]() | Help F1 | Click this button to show reference page. | All |
![]() | Refresh F5 | 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 Local-remote folders | |
![]() |
Synchronize Selected Enter | 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 Ctrl+Enter | 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. | All | |
Path |
These fields show the paths to the folders being compared.
To change a directory, click the Browse button ![]() |
Local folders Local-remote folders |
List of items
The list shows the items from the compared objects that meet the comparison criterion specified in the Compare by drop-down list and the filtering criteria specified through the toolbar buttons.
Item | Description | Available for | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 Local-remote folders | ||||||||||||
Date | These read-only fields show the timestamps of files under the folders being compared. |
Local folders Local-remote 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 ![]() ![]() To change the currently selected action, click the icon.
| All |
Differences pane
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.
Context menu
This menu appears on right-clicking an entry in the list of items. The commands listed below define actions to be taken for the selected entry and set the action icons in the * column.
Item | Icon | Description |
---|---|---|
Set Copy to Right/Left | ![]() ![]() | This command sets the specified icons in the * column to copy a file missing from one of the directories. If a file exists on one side, it will be copied; if it doesn't exist, then the file on the other side will not be deleted. |
Set Delete | ![]() | This command sets the specified icons in the * column to delete file. |
Set Do Nothing | Choose this command to remove an action icon. | |
Set Default | Choose this command to set the default action for the entry. | |
Warn When Delete | Select this option to display a warning when trying to delete a file that is located only in one of the two directories during their merge. |