nodegit-kit

NodeGit-Kit

Promises for git commands such as git init, git status, git add *, git diff, git log and git commit -am"commit message".

Comments are welcome at nodegit-kit/issues

Install

npm i --save nodegit-kit

Usage

var git = require('nodegit-kit');

git.open('../repo-path/new/or/existing')
.then(function(repo){

     // git diff
    return git.diff(repo)
    .then(function(diff){
        console.log(diff);

        // git commit -am"commit message"
        return git.commit(repo, {
            'message': 'commit message'
        });
    })
    .then(function(){
        // git log
        return git.log(repo);
    })
    .then(function(log){
        console.log(log);
    });
})
.catch(function(error){
    console.error(error);
});

git status

git.open('../repo-path/new/or/existing')
.then(function(repo){
    // git status
    return git.status(repo);
})
.then(function(status){
    console.log(status);
});

git config

Allows to write/read global and local values. Local values are stored in the Git directory ./git/config and overrule global configurations. Git locks the config when changing configurations, therefore modifications can not be done in parallel, e.g. Promise.all multiple individual git.config.set calls will throw a failed to lock file for writing error.

See also 8.1 Customizing Git - Git Configuration (Git SCM Documentation)

Example set name and email for a specific repository

Setting user name and email similar to git config user.name "John Doe" and git config user.email [e-mail].

git.open('my/repository')
.then(function(repo){
    return git.config.set(repo, {
        'user.name': 'John Doe',
        'user.email': '[e-mail]'
    });
});

Example reading user.name and user.email

Similar to git config user.name returns config for a repository if there any or else the global Git configuration.

git.open('my/repository')
.then(function(repo){
    return git.config.get(repo, ['user.name', 'user.email']);
})
.then(function(configs){
    // [ 'John Doe', '[e-mail]' ]
});

Example working with global Git configuration

When no repo is given setting and getting config will operate in --global mode and read and write to ~/.gitconfig (or ~/.config/git/config).

git.config.get(['user.name', 'user.email'])
.then(function(config){
    // [ 'John Doe', '[e-mail]' ]
});

// warning this will change your global git config
git.config.set({
    'user.name': 'John Doe',
    'user.email': '[e-mail]'
});

Test

npm install

npm test

# debug nodegit-kit
DEBUG=kit* npm test

# debug all
DEBUG=* npm test