added readme file
This commit is contained in:
60
README.md
Normal file
60
README.md
Normal file
@@ -0,0 +1,60 @@
|
|||||||
|
Geef (Git NIF)
|
||||||
|
================
|
||||||
|
|
||||||
|
Geef is a simple Erlang NIF that exposes some of the libgit2 library functions
|
||||||
|
to Erlang.
|
||||||
|
|
||||||
|
INSTALLING AND RUNNING
|
||||||
|
========================
|
||||||
|
|
||||||
|
First you need to install libgit2 (gsoc edition):
|
||||||
|
|
||||||
|
$ git clone git://github.com/tanoku/libgit2-gsoc2010.git
|
||||||
|
$ cd libgit2
|
||||||
|
$ make
|
||||||
|
$ make install
|
||||||
|
|
||||||
|
Now, if you have Erlang OTP_R13B04 installed, you can compile this NIF to run
|
||||||
|
in it.
|
||||||
|
|
||||||
|
$ git clone git://github.com/schacon/geef.git
|
||||||
|
$ cd geef
|
||||||
|
$ make
|
||||||
|
|
||||||
|
Now you should have a .beam file you can load. I've also included an example
|
||||||
|
escript to test some of the functions (currently just hex_to_raw and object_exists):
|
||||||
|
|
||||||
|
$ ./geef h2r de08fe4884650f067bd5703b8a59a8b3b3c99aaa
|
||||||
|
Raw: <<222,8,254,72,132,101,15,6,123,213,112,59,138,89,168,179,179,201,154,170>>
|
||||||
|
|
||||||
|
$ ./geef exists .git/objects 89c86150c8b164f441a73f4991b2c339fd4aae7c
|
||||||
|
Exists: true
|
||||||
|
|
||||||
|
$ ./geef exists .git/objects 87fcfb277899097823911006f438658ce86b3697
|
||||||
|
Exists: false
|
||||||
|
|
||||||
|
The API looks basically like this:
|
||||||
|
|
||||||
|
geef:start().
|
||||||
|
Raw = geef:hex_to_raw(HexSha).
|
||||||
|
Exists = geef:object_exists(ObjectsPath, HexSha).
|
||||||
|
|
||||||
|
|
||||||
|
CONTRIBUTING
|
||||||
|
==============
|
||||||
|
|
||||||
|
Fork schacon/ribbit on GitHub, make it awesomer (preferably in a branch named
|
||||||
|
for the topic), send a pull request.
|
||||||
|
|
||||||
|
|
||||||
|
AUTHORS
|
||||||
|
==============
|
||||||
|
|
||||||
|
Scott Chacon <schacon@gmail.com>
|
||||||
|
|
||||||
|
|
||||||
|
LICENSE
|
||||||
|
==============
|
||||||
|
|
||||||
|
MIT.
|
||||||
|
|
||||||
Reference in New Issue
Block a user