measurement-kit / go-measurement-kit

[DEPRECATED] Golang bindings for measurement-kit

Go bindings for C++ Measurement Kit code

⚠️⚠️⚠️⚠️⚠️⚠️⚠️: This repository is superseded by https://github.com/ooni/probe-engine and will be archived and replaced by probe-engine as soon as we finish updating https://github.com/ooni/probe-cli to use probe-engine. Therefore, please, make sure you don't depend on this code.

Measurement Kit bindings for Go. The code in this repository exposes some APIs of Measurement Kit's C++ implementation to Go apps.

Attention this is work on progress and is highly unstable.

Do not use it for anything serious, for the moment.

Getting started

Install MaxMind databases using:

./script/download-mmdb.sh

macOS

Install Measurement Kit using brew:

brew tap measurement-kit/measurement-kit
brew install measurement-kit

If you've already installed measurement-kit, do:

brew upgrade

to make sure you're on the latest released version.

Then you're all set. Just go get -v ./... as usual.

MingGW

Install Measurement Kit using brew:

brew tap measurement-kit/measurement-kit
brew install mingw-w64-measurement-kit

If you've already installed mingw-w64-measurement-kit, do:

brew upgrade

to make sure you're on the latest released version.

Then you're all set. Because you're cross compiling you need to provide more environment variables to make the build work:

CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++                           \
  CGO_ENABLED=1 GOOS=windows GOARCH=amd64 go get -v ./...

To test binaries, you can use wine:

wine $GOPATH/bin/windows_amd64/web_connectivity.exe 

It is recommended to also test using a real Windows box.

Linux

We have a Docker container. Build the container with:

docker build -t gomkbuild .

Enter into the container with:

docker run -it -v`pwd`:/gomkbuild -w/gomkbuild gomkbuild

Then you're all set. Just go get -v ./... as usual.

Examples

See the _examples/ directory.