-
Notifications
You must be signed in to change notification settings - Fork 25
/
README
50 lines (32 loc) · 1.7 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
gitgo
========
[![GoDoc](https://godoc.org/github.com/ChimeraCoder/gitgo?status.svg)](https://godoc.org/github.com/ChimeraCoder/gitgo)
[![Build Status](https://travis-ci.org/ChimeraCoder/gitgo.svg?branch=master)](https://travis-ci.org/ChimeraCoder/gitgo)
Gitgo provides Go functions for interacting with Git repositories.
Unlike libgit2, which is written in C, Gitgo is written in pure Go, and can be compiled and cross-compiled easily for all platforms supported by Go.
Installation
--------------
`
$ go get github.com/ChimeraCoder/gitgo
`
Usage
---------
Full documentation is available on [GoDoc](https://godoc.org/github.com/ChimeraCoder/gitgo).
Gitgo is a library intended to be used by other applications, rather than a replacement for the `git` command-line tools. However, gitgo does provide the `gitgo` binary, which is used for testing the gitgo library functions and demonstrating their functionality:
````
$ cd $GOPATH/src/github.com/ChimeraCoder/gitgo
$ gitgo log 1d833eb5b6c5369c0cb7a4a3e20ded237490145f
commit 1d833eb5b6c5369c0cb7a4a3e20ded237490145f
Author: aditya <[email protected]>
Date: Mon Apr 6 15:49:15 2015 -0400
Parse git object into struct and add corresponding test
commit a7f92c920ce85f07a33f948aa4fa2548b270024f
Author: aditya <[email protected]>
Date: Fri Apr 3 12:38:24 2015 -0400
Add CatFile function and corresponding test
commit 97eed02ebe122df8fdd853c1215d8775f3d9f1a1
Author: aditya <[email protected]>
Date: Fri Apr 3 11:45:00 2015 -0400
First commit. Create .gitignore
````
Note that the `gitgo` binary does not support all (or even most) of the functions provided by the gitgo library; it is intended for demonstration purposes and testing only.