Metadata-Version: 2.1
Name: git_alias
Version: 0.0.1
Summary: Tools for managing git aliases
Home-page: https://github.com/larsks/git-alias/
Author: Lars Kellogg-Stedman
Author-email: lars@oddbit.com
License: UNKNOWN
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}\" # "
        ```
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
