I usually work on different Git projects that need different Git identities. My work flow for new repositories was
- Clone new repository.
- Go to cloned repository.
- If it is necessary to change the Git identity, call a shell script that runs `git config user.name “Sandra Parsick”; git config user.email email@example.com`
The first method is based on the Git feature “Conditional Includes” (required Git Version at least 2.13). The idea is that you define a default Git identity and separate Git identities per specific directory. That means every repository that is cloned beneath one of the specific directory, has automatically its specified Git identities.
The second method is based on a Python script, that is inspired by the Mercurial extension hg-persona. The idea is that you can individually set a Git identity per Git repository. It is a one command replacement for the git config user.*command serie.
In the next two sections, I’d like to summarize how to set up and how to use these two methods. I have tested it on a Debian-based system. Let’s start with the first one.
Summarize Git Identity for Several Git Repositories
As above described, this method is based on the Git feature “Conditional Includes.” Therefore, ensure you have installed your Git client in at least version 2.13. Assume, we want to have two Git identities, one for Github and one for work. Therefore, create two .gitconfig files in your home folder.
touch ~/.gitconfig_github touch ~/.gitconfig_work
Then add the specific Git identity in respective .gitconfig files.
~/.gitconfig_github [user] name = YourNameForGithub email = firstname.lastname@example.org
~/.gitconfig_work [user] name = YourNameForWork email = email@example.com
The next step is to add these two .gitconfig files to our global one and to specify when to use them.
~/.gitconfig [user] name = defaultName email = firstname.lastname@example.org [includeIf "gitdir:~/workspace_work/"] path = .gitconfig_work [includeIf "gitdir:~/workspace_github/"] path = .gitconfig_github
Now, every repository, that is cloned beneath ~/workspace_work/, has automatically the Git identity for Work (.gitconfig_work) and every repository, that is cloned beneath ~/workspace_github/, has automatically the Git identity for Github (.gitconfig_github). Otherwise, the default Git identity is used.
Setting Git Identity Individually Per Git Repository
For the second method, you have to install ws.git-persona from PyPI.
sudo apt-get install pip # if PyPI isn't install pip install ws.git-persona
Then, open your global ~/.gitconfig and add your personas. In our cases, we add two personas, one for Github and one for work.
~/.gitconfig [persona] github = YourNameForGithub <email@example.com> work = YourNameForWork <firstname.lastname@example.org>
In the next step, we want to switch our Git identity in a Git repository. This is now possible with the command git-persona. In the following example, we switch to the identity for Github and then to the identity for work.
> git-persona -n github Setting user.name="YourNameForGithub", user.email="email@example.com" > git config user.name YourNameForGithub > git config user.email firstname.lastname@example.org > git-persona -n work Setting user.name="YourNameForWork", user.email="email@example.com" > git config user.email firstname.lastname@example.org > git config user.name YourNameForWork
If you have other methods to manage different Git identities, let me know it and write a comment.