Pimp My Git - Manage Different Git Identities
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 bases 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 bases 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 an 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 bases 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.
1touch ~/.gitconfig_github 2touch ~/.gitconfig_work
Then add the specific Git identity in respective
1~/.gitconfig_github 2 3[user] 4 name = YourNameForGithub 5 email = firstname.lastname@example.org 6 7~/.gitconfig_work 8 9[user] 10 name = YourNameForWork 11 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.
1~/.gitconfig 2 3[user] 4 name = defaultName 5 email = firstname.lastname@example.org 6 7[includeIf "gitdir:~/workspace_work/"] 8 path = .gitconfig_work 9 10[includeIf "gitdir:~/workspace_github/"] 11 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.
1sudo apt-get install pip # if PyPI isn't install 2pip 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.
1~/.gitconfig 2 3[persona] 4 github = YourNameForGithub <email@example.com> 5 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.
1> git-persona -n github 2Setting user.name="YourNameForGithub", user.email="email@example.com" 3> git config user.name 4YourNameForGithub 5> git config user.email firstname.lastname@example.org 7> git-persona -n work 8Setting user.name="YourNameForWork", user.email="email@example.com" 9> git config user.email firstname.lastname@example.org 11> git config user.name 12YourNameForWork
If you have other methods to manage different Git identities, let me know it and write a comment.