git-exec v0.2.1

git-exec

This library provides a very simple wrapper around the git binary.

Getting Started

Install the module with: npm install git-exec

Documentation

The majority of the interaction involves an exec() method which is involved on a instances of the library. This method is relatively stupid in that we do not try to parse the output or validate commands invoked.

However, we do take care to provide a means to both init / clone git repositories and we set the working directory correctly such that further git commands execute in the correct context.

Examples

Cloning a remote repository and switching to the 'dev' branch

var Git = require('git-exec');
Git.clone(a-repo.git, 'dir', function(repo) {
  // NOTE the callback is given a reference to the git repository

  repo.exec('checkout', ['-t origin/dev'], function() {
    // ... callback to execute after branch checkout
  });
});

Using a local git repository

var Git = require('git-exec');
var repo = new Git('./path/to/repo');

repo.exec('pull', null, function() {
  // ... callback to execute after git pull
});

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.

Release History

• 0.1.0 - initial release

License

Copyright (c) 2012 Alex J Burke Licensed under the MIT license.