Check out a project from a remote host clone PyCharm allows you to check out in Git terms clone an existing repository and create a new project based on the data you've downloaded. If you want to create a PyCharm project based on the sources you have cloned, click Yes in the confirmation dialog. Git root mapping will be automatically set to the project root directory. If your project containsthey will also be cloned and automatically registered as project roots. Put an existing project under Git version control Apart fromyou can create a local repository based on an existing project's sources. Git does not support external paths, so if you choose a directory that is outside your project root, make sure that the folder where the repository is going to be created also contains the project root. Add files to the local repository After you have for your project, you need to add project data to git show repository url. Open the Version Control tool window Alt+9 and switch to the Local Changes tab. You can either add the entire changelist, or select separate files. If you have enabled Git integration for your project, PyCharm suggests to add each newly created file under Git version control you can change this behavior in the Settings dialog Ctrl+Alt+S under Version Control Confirmation. If you want certain files to always remain unversioned, you can. You can also add files to your local Git repository from the Project tool window. Select the files you want to add, and press Ctrl+Alt+A or choose Git Add from the context menu. Exclude files from version control ignore Sometimes you may need to leave files of certain types unversioned. Once you've added a file to Git version control, ignoring it will have no effect. You need to remove it from the Git repository first. Click on the toolbar and choose Configure Ignored Files. The rule is applied recursively to all subdirectories. The rule is applied to all directories under the project root. You can also add files to the ignore by choosing Ignore from the context menu of a newly added file under the Unversioned Files node in the Local Changes view. Check project status PyCharm allows you to check the status of your local working copy compared to the repository version of the project. If there were conflicts during a merge that were not resolved, the Merge Conflicts node will appear in the corresponding changelist with a link to them: For more info on changelists, see. If you want to be also displayed in the Local Changes view, click on the toolbar and select Show Ignored Files. Track changes to a file in the editor You can also track changes to a file as you git show repository url it in the editor. All changes are highlighted with change markers that appear in the left gutter next to the modified lines, and show the type of changes introduced since you last. When you commit changes to the repository, change markers disappear. When you delete a line, the following marker appears in the left gutter:. You can manage changes using a toolbar that appears when you hover the mouse cursor over a change marker and then click it. The toolbar is displayed together with a frame showing the previous contents of the modified line: You can rollback changes by clicking note that all changes to the file since its last revision will be reverted, not just the current lineand explore the differences between the current and the repository version of the current line by clicking. Instead of reverting the whole file, you can copy any part of the contents of this popup and paste it into the editor. Add a remote repository To be able to collaborate on your Git project, you need to configure remote repositories that you data from and to when you need to share your work. If you havefor example fromthe remote is configured automatically and you do not have to specify it when you want to synchronize with it i. The default git show repository url Git gives to the remote you've cloned from is origin. However, if you based on local sources, you need to add a remote repository for other contributors to be able to push their changes to it, and for you to be able to share the results of your work. Click it to add a remote. You can also add a remote from the Push dialog by clicking an existing remote's name. In some cases, you also need to add a second remote repository. This may be useful, for example, if you have cloned a repository that you do not have write access to, and you are going to push changes to your own of the original project. Another common scenario is that you have cloned your own repository that is somebody else's project fork, and you need to synchronize with the original project and fetch changes from it. The Git Remotes dialog will open. Learn more from this video: To edit a remote for example, to change the name of the original project that you have clonedselect git show repository url in the Git Remotes dialog and click the Edit button on the toolbar, or press Enter. To remove a repository that is no longer valid, select it in the Git Remotes dialog and click the Remove button on the toolbar, or press Alt+Delete. You can also edit a remote from the by clicking its name.
