Skip to content
The Riak client for Go.
Branch: master
Clone or download
Latest commit 5587c16 Mar 27, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
build remove buildbot Makefile Oct 15, 2016
examples
riak_pb @ cb15cc4
rpb Add per-file headers Jan 10, 2017
tools @ 1f54803
.gitattributes
.gitignore
.gitmodules
.travis.yml
LICENSE Add necessary files for riak-go-client. Jun 1, 2015
Makefile
NOTICE
README.md
RELNOTES.md 1.9.1 RELNOTES Mar 27, 2017
async.go
benchmark_test.go
client.go
client_i_test.go Add per-file headers Jan 10, 2017
client_test.go
cluster.go
cluster_i_test.go
cluster_test.go
command.go Add code to block listing buckets and keys unless WithAllowListing() … Jan 31, 2017
command_i_test.go
command_rpb_test.go
command_test.go Add per-file headers Jan 10, 2017
connection.go
connection_i_test.go
connection_manager.go
connection_manager_i_test.go
connection_manager_test.go
connection_test.go Add per-file headers Jan 10, 2017
consts.go
crdt_commands.go
crdt_commands_i_test.go Skip() in the correct spot Jan 12, 2017
crdt_commands_test.go Add test for encoding three Object fields Mar 27, 2017
doc.go
error.go
error_test.go
gh_issues_i_test.go Add per-file headers Jan 10, 2017
globals_i_test.go
globals_test.go
kv_commands.go Add code to block listing buckets and keys unless WithAllowListing() … Jan 31, 2017
kv_commands_i_test.go
kv_commands_test.go
locatable.go
logging.go
logging_test.go
make.cmd
make.ps1
messages.go
misc_commands.go
misc_commands_i_test.go
misc_commands_test.go
net.go Add per-file headers Jan 10, 2017
node.go
node_i_test.go
node_manager.go
node_test.go
object.go
object_test.go
queue.go Add per-file headers Jan 10, 2017
queue_test.go
rpb.go
security_test.go
states.go
states_test.go
ts_commands.go Add code to block listing buckets and keys unless WithAllowListing() … Jan 31, 2017
ts_commands_i_test.go
ts_commands_test.go
yz_commands.go Fix examples of New* commands lack of err variables Jan 17, 2017
yz_commands_i_test.go
yz_commands_test.go

README.md

Riak Go Client

The Riak Go Client is a client which makes it easy to communicate with Riak, an open source, distributed database that focuses on high availability, horizontal scalability, and predictable latency. Both Riak and this code is maintained by Basho.

The latest version of the client supports both Riak KV 2.0+, and Riak TS 1.0+.

Build Status

Build Status

Installation

go get github.com/basho/riak-go-client

Documentation

Testing / Contributing

This repository's maintainers are engineers at Basho and we welcome your contribution to the project! Review the details in CONTRIBUTING.md in order to give back to this project.

Note: Please clone this repository in such a manner that submodules are also cloned:

git clone --recursive https://github.com/basho/riak-go-client

OR:

git clone https://github.com/basho/riak-go-client
git submodule init --update

Unit Tests

make unit-test

Integration Tests

You have two options to run Riak locally - either build from source, or use a pre-installed Riak package.

Source

To setup the default test configuration, build a Riak node from a clone of github.com/basho/riak:

# check out latest release tag
git checkout riak-2.1.4
make locked-deps
make rel

Source build documentation.

When building from source, the protocol buffers port will be 8087 and HTTP will be 8098.

Package

Install using your platform's package manager (docs)

When installing from a package, the protocol buffers port will be 8087 and HTTP will be 8098.

Running Integration Tests

  • Ensure you've initialized this repo's submodules:
git submodule update --init
  • Run the following:
./tools/setup-riak
make integration-test

This repository's maintainers are engineers at Basho and we welcome your contribution to the project! Review the details in CONTRIBUTING.md in order to give back to this project.

An honest disclaimer

Due to our obsession with stability and our rich ecosystem of users, community updates on this repo may take a little longer to review.

The most helpful way to contribute is by reporting your experience through issues. Issues may not be updated while we review internally, but they're still incredibly appreciated.

Thank you for being part of the community! We love you for it.

Roadmap

  • 1.0.0 - Full Riak 2 support with command queuing and retries.

License

The Riak Go Client is Open Source software released under the Apache 2.0 License. Please see the LICENSE file for full license details.

These excellent community projects inspired this client and parts of their code are in riak-go-client as well:

Authors

Contributors

Thank you to all of our contributors!

You can’t perform that action at this time.