Skip to main content

Tools for managing git aliases

Project description

git-alias: manage your Git aliases

git-alias is a tool for managing your git aliases.

Install

To install a released version of git-alias:

pip install git-alias

Or to install straight from GitHub:

pip install git+https://github.com/larsks/git-alias

git-alias requires Python 3.7 or later.

Managing aliases

Listing aliases

$ git alias list
conflicts
fix
please
pr
tracking

Installing from a local file

$ git alias -v install examples/pr.alias
INFO:git_alias.main:installing alias pr from examples/pr.alias

Installing from a git repository

$ git alias -v add -R https://github.com/larsks/git-alias examples/pr.alias
INFO:git_alias.main:cloning https://github.com/larsks/git-alias
INFO:git_alias.main:installing alias pr from /tmp/aliasmylwfb93/examples/pr.alias

Show alias expansion

$ git alias show pr
!if [ $# -eq 1 ]; then set -- origin $1; elif [ $# -ne 2 ]; then echo
'Usage: git pr [<remote>] <pr>'; exit 2; fi; git fetch "${1}"
"+pull/${2}/head:pull/${1}/${2}"; git log -1 "pull/${1}/${2}" #

Alias file format

Blank lines and lines beginning with # are discarded. The remaining content will be joined on spaces. For example, this file:

# Create a local branch from a pull request
#
# usage: git pr [<remote>] <pr>
#
# Get a pull request from origin:
#
#   git pr 42
#   git pr origin 42
#
# Either of the above would create local branch pull/origin/42.
#
# Get a pull request from another remote:
#
#   git pr upstream 42

!if [ $# -eq 1 ]; then
  set -- origin $1;
elif [ $# -ne 2 ]; then
  echo 'Usage: git pr [<remote>] <pr>';
  exit 2;
fi;
git fetch "${1}" "+pull/${2}/head:pull/${1}/${2}"; git log -1 "pull/${1}/${2}" #

Results in the following entry in your git configuration file:

	pr = "!if [ $# -eq 1 ]; then set -- origin $1; elif [ $# -ne 2 ]; then echo 'Usage: git pr [<remote>] <pr>'; exit 2; fi; git fetch \"${1}\" \"+pull/${2}/head:pull/${1}/${2}\"; git log -1 \"pull/${1}/${2}\" # "

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

git_alias-0.0.2.tar.gz (3.8 kB view hashes)

Uploaded Source

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