Go bindings for libgit2.
Due to the fact that Go 1.11 module versions have semantic meaning and don't necessarily align with libgit2's release schedule, please consult the following table for a mapping between libgit2 and git2go module versions:
libgit2 | git2go |
---|---|
main | (will be v35) |
1.5 | v34 |
1.3 | v33 |
1.2 | v32 |
1.1 | v31 |
1.0 | v30 |
0.99 | v29 |
0.28 | v28 |
0.27 | v27 |
You can import them in your project with the version's major number as a suffix. For example, if you have libgit2 v1.2 installed, you'd import git2go v34 with:
go get github.com/libgit2/git2go/v34
import "github.com/libgit2/git2go/v34"
which will ensure there are no sudden changes to the API.
The main
branch follows the tip of libgit2 itself (with some lag) and as such has no guarantees on the stability of libgit2's API. Thus this only supports statically linking against libgit2.
If there's something version-specific that you'd want to contribute to, you can send them to the release-${MAJOR}.${MINOR}
branches, which follow libgit2's releases.
This project wraps the functionality provided by libgit2. It thus needs it in order to perform the work.
This project wraps the functionality provided by libgit2. If you're using a versioned branch, install it to your system via your system's package manager and then install git2go.
When linking dynamically against a released version of libgit2, install it via your system's package manager. CGo will take care of finding its pkg-config file and set up the linking. Import via Go modules, e.g. to work against libgit2 v1.2
import "github.com/libgit2/git2go/v34"
Follow the instructions for Versioned branch, dynamic linking, but pass the -tags static,system_libgit2
flag to all go
commands that build any binaries. For instance:
go build -tags static,system_libgit2 github.com/my/project/...
go test -tags static,system_libgit2 github.com/my/project/...
go install -tags static,system_libgit2 github.com/my/project/...
If using main
or building a branch with the vendored libgit2 statically, we need to build libgit2 first. In order to build it, you need cmake
, pkg-config
and a C compiler. You will also need the development packages for OpenSSL (outside of Windows or macOS) and LibSSH2 installed if you want libgit2 to support HTTPS and SSH respectively. Note that even if libgit2 is included in the resulting binary, its dependencies will not be.
Run go get -d github.com/libgit2/git2go
to download the code and go to your $GOPATH/src/github.com/libgit2/git2go
directory. From there, we need to build the C code and put it into the resulting go binary.
git submodule update --init # get libgit2
make install-static
will compile libgit2, link it into git2go and install it. The main
branch is set up to follow the specific libgit2 version that is vendored, so trying dynamic linking may or may not work depending on the exact versions involved.
In order to let Go pass the correct flags to pkg-config
, -tags static
needs to be passed to all go
commands that build any binaries. For instance:
go build -tags static github.com/my/project/...
go test -tags static github.com/my/project/...
go install -tags static github.com/my/project/...
One thing to take into account is that since Go expects the pkg-config
file to be within the same directory where make install-static
was called, so the go.mod
file may need to have a replace
directive so that the correct setup is achieved. So if git2go
is checked out at $GOPATH/src/github.com/libgit2/git2go
and your project at $GOPATH/src/github.com/my/project
, the go.mod
file of github.com/my/project
might need to have a line like
replace github.com/libgit2/git2go/v34 => ../../libgit2/git2go
libgit2 may use OpenSSL and LibSSH2 for performing encrypted network connections. For now, git2go asks libgit2 to set locking for OpenSSL. This makes HTTPS connections thread-safe, but it is fragile and will likely stop doing it soon. This may also make SSH connections thread-safe if your copy of libssh2 is linked against OpenSSL. Check libgit2's THREADSAFE.md
for more information.
For the stable version, go test
will work as usual. For the main
branch, similarly to installing, running the tests requires building a local libgit2 library, so the Makefile provides a wrapper that makes sure it's built
make test-static
Alternatively, you can build the library manually first and then run the tests
make install-static
go test -v -tags static ./...
M to the I to the T. See the LICENSE file if you've never seen an MIT license before.
- Carlos Martín (@carlosmn)
- Vicent Martí (@vmg)