/git-passport

A Git command and hook written in Python to manage multiple Git users / user identities.

Primary LanguagePythonOtherNOASSERTION

What is git-passport?

git-passport is a Git command and hook written in Python to manage multiple Git users / user identities.

Get it!

>:mkdir -p ~/.git/hooks/bin && cd $_
>:git clone git://github.com/frace/git-passport.git
>:chmod +x ./git-passport/gitpassport.py
>:_

Installation

There are many ways to handle your hooks. What I do in oder to work with multiple hooks is the following solution:

>:mkdir -p ~/.git/hooks/pre-commit.d && cd $_
>:ln -sf ~/.git/hooks/bin/git-passport/gitpassport.py ./00-gitpassport
>:mkdir -p ~/.git/templates/hooks && cd $_
>:touch pre-commit && chmod +x $_
>:_

Add the Git template directory path into your ~/.gitconfig and create an alias in order to be able to execute the script manually as a «native» git command by invoking git passport:

[alias]
    passport = !${HOME}/.git/hooks/bin/git-passport/gitpassport.py

[init]
    templatedir = ~/.git/templates

In ~/.git/templates/hooks/pre-commit I put a little bash script which loads one hook after another:

>:cat ~/.git/templates/hooks/pre-commit
#!/usr/bin/env bash

hooks_pre_commit="${HOME}/.git/hooks/pre-commit.d/"

for hook in ${hooks_pre_commit}*; do
    "$hook"
done
>:_

Afterwards each git init or git clone command will distribute the hook into a new repository. If you want to apply the hook to already exisiting repos then just run git init inside the repository in order to reinitialize it.

Configuration

On the first run gitpassport.py generates a sample configuration file inside your home directory:

>:cd ~/.git/hooks/bin/git-passport
>:./gitpassport.py
No configuration file found in ~/.
Generating a sample configuration file.
>:_

The configuration file is rather self-explanatory:

>:cat ~/.gitpassport
[general]
enable_hook = True
sleep_duration = 0.5

[passport 0]
email = email_0@example.com
name = name_0
service = github.com

[passport 1]
email = email_1@example.com
name = name_1
service = gitlab.com
>:_

Adjust the existing sections and add as many passports as you like by following the section scheme.

Usage

If you setup the script as a hook only it will be invoked automatically during each git commit command. You can pass the following options if you use gitpassport.py as a Git command, too:

>:git passport -h
usage: git passport (-h | --choose | --remove | --show)

manage multiple Git identities

optional arguments:
  -h            show this help message and exit
  -c, --choose  choose a passport
  -r, --remove  remove a passport from a .git/config
  -s, --show    show the active passport set in .git/config
>:_

Bugs

You are welcome to report bugs at the project bugtracker at github.com.

Credits: