Skip to main content

Command-line tool for managing multiple git identities on the same machine

Project description

GitID

GitID is a command-line tool for managing multiple git identities on the same machine. This is particularly useful for shared machines where multiple people develop in the same workspaces, which is in some cases unavoidable.

With GitID, users can store their git identities and quickly load them in their shell, so their commits are marked with their name and email.

Note that GitID only sets commit authors and committers, and does not affect authorization.

Installation

Installation is easy:

pip install gitid
gitid init bash # change to your shell of choice

Installation Issues

Some environments may not place the script on the path. If your shell can't find the gitid script, you can do one of the following:

Install with sudo:

sudo -H pip install gitid

Or add the following snippet to your ~/.bashrc (or equivalent startup file):

export PATH="$PATH:<PATH_TO_GITID>"

Unsupported shell

If your shell is unsupported by gitid init, simply add alias gitid="source gitid" to the appropriate startup file of your shell.

Workflow

Suppose both Frodo Baggins and Samwise Gamgee want to develop on the same computer. They would add their git identities like so:

gitid add frodo "Frodo Baggins" frodo@shire.com
gitid add sam "Samwise Gamgee" sam@shire.com

Now Frodo wants to write some code:

gitid set frodo
... git commands ...
git commit # This commit is marked with "Frodo Baggins <frodo@shire.com>" as the committer and author

Separately, possibly at the same time (in a different session), Samwise also wants to write code:

gitid set sam
... git commands ...
git commit # This commit is marked with "Samwise Gamgee <sam@shire.com>" as the committer and author

All identities can be viewed:

gitid list

Which outputs: (* marks the active identity)

Stored identities:
    ( ) frodo: Frodo Baggins <frodo@shire.com>
    (*) sam: Samwise Gamgee <sam@shire.com>

Identities can also be removed:

gitid remove frodo # removes Frodo's identity
gitid clear # removes all stored identities

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitid-0.2.5.tar.gz (5.8 kB view hashes)

Uploaded Source

Built Distribution

gitid-0.2.5-py3-none-any.whl (6.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page