PyCharm 2021.2 Help

Add files to a local Mercurial repository

After a Mercurial repository for a project is initialized, you need to add the project data to it:

  • If you have specified Mercurial as the version control system for your project in the Settings dialog, PyCharm suggests to put each new file under Mercurial control during the file creation.

  • You can add all unversioned files to Mercurial control or select files to add.

To add all currently unversioned files to Mercurial control

  1. Open the Commit tool window Alt+0

  2. Navigate to the Unversioned Files node and choose Add to VCS from the context menu.

To add specific file(s) to a local Mercurial repository, do one of the following:

  • Switch to the Commit tool window Alt+0, expand the Unversioned Files node, and select the files to be added. From the context menu, choose Add to VCS.

To specify the commit options

  • If you need to perform pre-commit checks, upload files to a server after the commit, or commit with advanced options, click the Gear icon:

    • In the Before Commit area, select the actions you want PyCharm to perform before committing the selected files to the local repository.

      The following options are available:

      • Reformat code: perform code formatting according to the Project Code Style settings.

      • Rearrange code: rearrange your code according to the arrangement rules preferences.

      • Optimize imports: remove redundant import statements.

      • Analyze code: analyze modified files before committing them. Click Choose profile to select an inspection profile from which the IDE will run inspections.

      • Check TODO (<filter name>): Review the TODO items matching the specified filter. Click Configure to choose an existing TODO filter, or open the TODO settings page and define a new filter to be applied.

      • Cleanup: batch-apply quick-fixes from code cleanup inspections. Click Choose profile to select a profile from which the IDE will run inspections.

      • Run Tests: run tests as pre-commit checks. Click Choose configuration near Run Tests and select which configuration you want to run.

      • Update copyright: add or update a copyright notice according to the selected copyright profile - scope combination.

    • In the After Commit area, you can select the server access configuration or a server group to use for uploading the committed files to a local or remote host, a mounted disk, or a directory. See Deploy for details.

      The following options are available:

      • Run tool: select the external tool that you want PyCharm to launch after the selected changes have been committed. You can select a tool from the list, or click the Browse button the Browse button and configure an external tool in the External Tools dialog that opens.

      • Upload files to: select the server access configuration or a server group to use for uploading the committed files to a local or remote host, a mounted disk, or a directory.

        • To suppress uploading, choose None.

        • To add a server configuration to the list, click the Browse button and fill in the required fields in the Add Server dialog that opens.

        The list is only available if the FTP/SFTP Connectivity plugin is enabled.

      • Always use selected server or group of servers: always upload files to the selected server or a server group.

        The checkbox is only available if the FTP/SFTP Connectivity plugin is enabled.

  • Switch to the Project tool window and select the files to be added. From the context menu, choose Mercurial | Add to VCS.

Last modified: 30 November 2021