commit | 519b8e16d67d00cc20e4cfcdcd3382e85bf42e5f | [log] [tgz] |
---|---|---|
author | Carlos Martín Nieto <cmn@dwim.me> | Tue Apr 21 13:14:22 2015 +0200 |
committer | Carlos Martín Nieto <cmn@dwim.me> | Tue Apr 21 13:14:22 2015 +0200 |
tree | 44bea1e0651747dd7698e552054c0afbc0758169 | |
parent | e021457f27654ea0f1ec41963c6da62c168be853 [diff] |
Introduce an indirection layer for pointers As the Go runtime can move stacks at any point and the C code runs concurrently with the rest of the system, we cannot assume that the payloads we give to the C code will stay valid for any particular duration. We must therefore give the C code handles which we can then look up in our own list when the callbacks get called.
Go bindings for libgit2. The master
branch follows the latest libgit2 release. The versioned branches indicate which libgit2 version they work against.
This project wraps the functionality provided by libgit2. If you‘re using a stable version, install it to your system via your system’s package manger and then install git2go as usual.
Otherwise (next
which tracks an unstable version), we need to build libgit2 as well. In order to build it, you need cmake
, pkg-config
and a C compiler. You will also need the development packages for OpenSSL and LibSSH2 installed if you want libgit2 to support HTTPS and SSH respectively.
git2go has master
which tracks the latest release of libgit2, and versioned branches which indicate which version of libgit2 they work against. Install the development package it on your system via your favourite package manager or from source and you can use a service like gopkg.in to use the appropriate version. For the libgit2 v0.22 case, you can use
import "gopkg.in/libgit2/git2go.v22"
to use a version of git2go which will work against libgit2 v0.22 and dynamically link to the library. You can use
import "github.com/libgit2/git2go"
to use the version which works against the latest release.
next
The next
branch follows libgit2's master branch, which means there is no stable API or ABI to link against. git2go can statically link against a vendored version of libgit2.
Run go get -d github.com/libgit2/git2go
to download the code and go to your $GOPATH/src/github.com/libgit2/git2go
dir. From there, we need to build the C code and put it into the resulting go binary.
git checkout next git submodule update --init # get libgit2 make install
will compile libgit2 and run go install
such that it's statically linked to the git2go package.
libgit2 uses 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 next
branch, similarly to installing, running the tests requires linking against the local libgit2 library, so the Makefile provides a wrapper
make test
alternatively, if you want to pass arguments to go test
, you can use the script that sets it all up
./script/with-static.sh go test -v
which will run the specified arguments with the correct environment variables.
M to the I to the T. See the LICENSE file if you've never seen a MIT license before.