gitteh

Node.js bindings for libgit2

Showing:

Popularity

Downloads/wk

0

GitHub Stars

427

Maintenance

Last Commit

7yrs ago

Contributors

19

Package

Dependencies

6

License

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Gitteh

build status npm version Dependency Status devDependency Status

Installation

Gitteh requires node 0.8 or 0.10, CMake 2.6 and gcc. Installation via NPM:

npm install gitteh

What?

Node bindings to the excellent libgit2 C library. Right now, the bindings cover read only access to raw objects (trees/commits/blobs/tags/references), and basic access to remotes (including basic cloning/fetching support).

Gitteh aims to:

  • Be simple and convenient
  • Be as performant as possible - avoids calling into underlying C library as much as possible.
  • Be safe for use in Node's threadpool (read: shouldn't segfault your app)

Why?

There's a few libraries out there that wrap git cli commands, parsing the output and such. This is a perfectly acceptable solution. Node-gitteh provides first-class support to work with a git repository on a low level, and does not require git.git (and its myriad of dependencies) to be installed in the server environment.

The documentation is currently outdated. We're working on a new version currently for the new 0.17.x version of gitteh. The Old pre-0.17.x documentation can be found here. Instead, you should visit examples dir in the repo to see examples of 0.17.x usage.

License

Gitteh is available under the MIT License. See the LICENSE file for more information.

Contributing

Contributions are very welcome. Please feel free to fork this project and hack on it. Go ahead and check out the issues tab to see what needs to be done! Go on! Do it!

Building

git clone https://github.com/libgit2/node-gitteh
cd node-gitteh && npm install

Happy hacking!

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial