@luiserebii/git-identity

    0.5.1-alpha • Public • Published

    git-identity

    git-identity-logo

    npm version GitHub Build Status Language grade: JavaScript Total alerts

    A command line tool allowing for easy shifting between git identities (username, email, and GPG).

    Version: 0.5.1-alpha
    Author: Luiserebii

    Usage

    Usage: git-identity [options]
    
    Options:
      -v, --version          output the version number
      -a, --about            about this tool
      -l, --list             list all registered identities
      -n, --new <name> *     add new identity
      -u, --update <name> *  update registered identity
      -d, --delete <name>    delete registered identity
      -s, --shift <name>     shift git identity to registered identity (global by default)
      -c, --current          current global git identity
      --global               global (option for -s and -c)
      --local                local (option for -s and -c)
      --user <username>      specify username
      --email <email>        specify email
      --gpg-key <gpg-key>    specify GPG key (key-id format: LONG)
      -h, --help             output usage information
    
    * uses additional flags below: 
    --user, --email, --gpg-key
    
    Usage: clone [options] [repo]
    
    Clone a repository and set the identity locally within. All flags accepted by git clone can also be used with this tool, and more information on their usage can be found within the git-scm documentation.
    
    Options:
      -i, --identity <name>            name of the git-identity to use
      -v, --verbose                    be more verbose
      -q, --quiet                      be more quiet
      --progress                       force progress reporting
      -n, --no-checkout                don't create a checkout
      --bare                           create a bare repository
      --mirror                         create a mirror repository (implies bare)
      -l, --local                      to clone from a local repository
      --no-hardlinks                   don't use local hardlinks, always copy
      -s, --shared                     setup as shared repository
      --recursive                      initialize submodules in the clone
      --recurse-submodules             initialize submodules in the clone
      --template <template-directory>  directory from which templates will be used
      --reference <repo>               reference repository
      --dissociate                     use --reference only while cloning
      -o, --origin <name>              use <name> instead of 'origin' to track upstream
      -b, --branch <branch>            checkout <branch> instead of the remote's HEAD
      -u, --upload-pack <path>         path to git-upload-pack on the remote
      --depth <depth>                  create a shallow clone of that depth
      --single-branch                  clone only one branch, HEAD or --branch
      --separate-git-dir <gitdir>      separate git dir from working tree
      -c, --config <key=value>         set config inside the new repository
      -h, --help                       output usage information
    

    Installation

    Linux

    To install, simply extract the tool into a preferred directory, compile, and create a soft link. For example, if you are looking to place the tool in your home directory:

    unzip git-identity-0.5.1-alpha.zip -d ~/
    cd ~/git-identity-0.5.1-alpha
    npm install
    npm run build
    sudo chmod u+x ~/git-identity-0.5.1-alpha/git-identity
    sudo ln -s ~/git-identity-0.5.1-alpha/git-identity /usr/local/bin/git-identity
    

    Doing this should make it globally accessible via git-identity.

    Alternatively, there is an INSTALL and UPDATE script, the latter of which should take any registered identities you had in the previous install and copy them over. NOTE: These are still untested and could break easily; until test cases are released for these, tread with caution.

    Mirror

    A mirror of this repository is available at: https://serebii.io:2501/Luiserebii/git-identity

    Contact

    Questions? Comments? Suggestions?
    Open an issue, make a pull request!

    Or, you can email me at: luis@serebii.io

    Keywords

    none

    Install

    npm i @luiserebii/git-identity

    DownloadsWeekly Downloads

    3

    Version

    0.5.1-alpha

    License

    MIT

    Unpacked Size

    43.2 kB

    Total Files

    26

    Last publish

    Collaborators

    • avatar