As of Feb 2012, gitteh now supports the latest version of libgit2 (0.16). This comes with some caveats however!
- You'll have to install from source because I can't get my changes pulled into the official repository, and therefore into the NPM.
- You'll have to install libgit2 from source FIRST, before you install gitteh.
- The test/ref.test.js test fails, so it's likely that ref's are borked.
Node bindings to the excellent libgit2 C library. The bindings cover most of the libgit2 API, however I took some liberties. For example...
- There's no notion of "oids" like in other libraries, all object ids are referenced by their 40 character SHA1 string.
- I didn't just write some quick bridge code to access libgit2 stuff, I took the time to distill the libgit2 API into an organized, intuitive set of objects you can work with.
- I avoided calling into C code where possible. This means that when you're composing a new commit for example, you can set most of the properties of the commit on a JS object as standard properties, then call save() when you're ready. Calling into C++ code is inherently expensive with V8.
- Although some of it is missing from the repo at the moment, I've written lots of little stress tests to make sure this library doesn't go ahead and segfault your server. Libgit2 isn't thread-safe at all. Hey, no need to thank me, it's all part of the job (it's why I get to wear a cape, and you don't). Essentially this means that you, libgit2, Node, and V8's garbage compiler can all play in the sandpit nicely together.
- I didn't bother wrapping blob API functions, since all they do is offer helper methods to load files into blobs, save blobs out to files etc. You can do all this with a RawObject, it exposes a Buffer with the contents of any objects in a git repo. Node has cooler filesystem stuff anyway.
- No animals were harmed during development, except that one little hamst... you know what? Never mind.
Why not? Libgit2 is an excellent way to work with a Git repository in a well-defined and speedy manner.
Or you could, you know, manually execute git CLI commands and parse stdout. Have fun with that.
You must install using the npm, but pointing at a local checkout of the git repo. Install libgit2 first:
$ git clone git://github.com/libgit2/libgit2.git
$ cd libgit2
$ mkdir build && cd build
$ cmake ..
$ make
$ make install
Make sure the lib files are somewhere that Node knows about. Run npm from the directory you want to install gitteh to, and point it at the checkout.
The current version of Gitteh requires libgit2 v0.16.0.
Documentation can be found here.. You should also check out the examples in the examples/ dir in the repo.
Actually, yes. I'd really appreciate any contributions on this project. Check out the TODO to see what still needs to be done, then get in contact with me BEFORE you start coding so I can make sure you're not doubling up work that's already under wraps :)