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

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!

Name		Name	Last commit message	Last commit date
Latest commit History 408 Commits
.github		.github
build		build
examples		examples
riak_pb @ cb15cc4		riak_pb @ cb15cc4
rpb		rpb
tools @ 1f54803		tools @ 1f54803
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.travis.yml		.travis.yml
LICENSE		LICENSE
Makefile		Makefile
NOTICE		NOTICE
README.md		README.md
RELNOTES.md		RELNOTES.md
async.go		async.go
benchmark_test.go		benchmark_test.go
client.go		client.go
client_i_test.go		client_i_test.go
client_test.go		client_test.go
cluster.go		cluster.go
cluster_i_test.go		cluster_i_test.go
cluster_test.go		cluster_test.go
command.go		command.go
command_i_test.go		command_i_test.go
command_rpb_test.go		command_rpb_test.go
command_test.go		command_test.go
connection.go		connection.go
connection_i_test.go		connection_i_test.go
connection_manager.go		connection_manager.go
connection_manager_i_test.go		connection_manager_i_test.go
connection_manager_test.go		connection_manager_test.go
connection_test.go		connection_test.go
consts.go		consts.go
crdt_commands.go		crdt_commands.go
crdt_commands_i_test.go		crdt_commands_i_test.go
crdt_commands_test.go		crdt_commands_test.go
doc.go		doc.go
error.go		error.go
error_test.go		error_test.go
gh_issues_i_test.go		gh_issues_i_test.go
globals_i_test.go		globals_i_test.go
globals_test.go		globals_test.go
kv_commands.go		kv_commands.go
kv_commands_i_test.go		kv_commands_i_test.go
kv_commands_test.go		kv_commands_test.go
locatable.go		locatable.go
logging.go		logging.go
logging_test.go		logging_test.go
make.cmd		make.cmd
make.ps1		make.ps1
messages.go		messages.go
misc_commands.go		misc_commands.go
misc_commands_i_test.go		misc_commands_i_test.go
misc_commands_test.go		misc_commands_test.go
net.go		net.go
node.go		node.go
node_i_test.go		node_i_test.go
node_manager.go		node_manager.go
node_test.go		node_test.go
object.go		object.go
object_test.go		object_test.go
queue.go		queue.go
queue_test.go		queue_test.go
rpb.go		rpb.go
security_test.go		security_test.go
states.go		states.go
states_test.go		states_test.go
ts_commands.go		ts_commands.go
ts_commands_i_test.go		ts_commands_i_test.go
ts_commands_test.go		ts_commands_test.go
yz_commands.go		yz_commands.go
yz_commands_i_test.go		yz_commands_i_test.go
yz_commands_test.go		yz_commands_test.go

License

mrbanzai/riak-go-client

Folders and files

Latest commit

History