This is a maintained Rust project that exposes the DataStax cpp driver at https://github.com/datastax/cpp-driver/ in a somewhat-sane crate. It was originally a fork of https://github.com/tupshin/cassandra-rs but that is no longer maintained.
It is a wrapper around the raw driver binding crate cassandra-cpp-sys.
For this crate to work, you must first have installed the datastax-cpp driver. Follow the steps in the cpp driver docs to do so. Pre-built packages are available for most platforms.
Make sure that the driver (specifically
libcassandra.so) are in your
See the API documentation.
The Cassandra Query Language (CQL) documentation is likely to be useful.
For a straightforward example see
Futures (version 0.15)
Since version 0.15, this crate uses
std::future, allowing your code to use
Previous versions (up to 0.14) used
futures:0.1. You can either remain on the 0.14 stream, update your code to use
std::future, or use a compatibility shim (e.g.,
Migrating from version 0.8
The API changed significantly in version 0.10. (Version 0.9 was skipped, for consistency with the
cassandra-cpp-sys version number.) For a summary of the main changes, see
This code is open source, licensed under the Apache License Version 2.0 as described in
CONTRIBUTING.md for details on how to contribute to this project.
This crate is regularly built by Travis; to see details of the most recent builds click on the "build" badge at the top of this page.
You must have the DataStax driver installed on your system in order to build this crate.
The unit tests assume Cassandra is running on the local host accessible on the standard port. The easiest way to achieve this is using Docker and the standard Cassandra image, with
docker pull cassandra docker run -d --net=host --name=cassandra cassandra
You should run them single-threaded to avoid the dreaded
org.apache.cassandra.exceptions.ConfigurationException: Column family ID mismatch error. The tests share a keyspace and tables, so if run in parallel they interfere with each other.
cargo test -- --test-threads 1
Remember to destroy the container when you're done:
docker stop cassandra docker rm cassandra
This project was forked from cassandra, which was no longer being maintained.