50 releases (18 breaking)

0.19.2 Jul 1, 2021
0.18.0 Apr 13, 2021
0.16.4 Feb 25, 2021
0.13.1 Oct 15, 2020
0.8.0 Nov 27, 2019

#6 in Database implementations

Download history 189/week @ 2021-04-07 109/week @ 2021-04-14 230/week @ 2021-04-21 58/week @ 2021-04-28 32/week @ 2021-05-05 214/week @ 2021-05-12 61/week @ 2021-05-19 5/week @ 2021-05-26 7/week @ 2021-06-02 66/week @ 2021-06-09 36/week @ 2021-06-16 29/week @ 2021-06-23 71/week @ 2021-06-30 83/week @ 2021-07-07 232/week @ 2021-07-14 21/week @ 2021-07-21

363 downloads per month

Apache-2.0

780KB
18K SLoC

terminusdb-store, a tokio-enabled data store for triple data

Build Status Crate Documentation codecov

Overview

This library implements a way to store triple data - data that consists of a subject, predicate and an object, where object can either be some value, or a node (a string that can appear both in subject and object position).

An example of triple data is:

cow says value(moo).
duck says value(quack).
cow likes node(duck).
duck hates node(cow).

In cow says value(moo), cow is the subject, says is the predicate, and value(moo) is the object.

In cow likes node(duck), cow is the subject, likes is the predicate, and node(duck) is the object.

terminusdb-store allows you to store a lot of such facts, and search through them efficiently.

This library is intended as a common base for anyone who wishes to build a database containing triple data. It makes very few assumptions on what valid data is, only focusing on the actual storage aspect.

This library is tokio-enabled. Any i/o and locking happens through futures, and as a result, many of the functions in this library return futures. These futures are intended to run on a tokio runtime, and many of them will fail outside of one. If you do not wish to use tokio, there's a small sync wrapper in store::sync which embeds its own tokio runtime, exposing a purely synchronous API.

Usage

Add this to your Cargo.toml:

[dependencies]
terminus-store = "0.16"

create a directory where you want the store to be, then open that store with

let store = terminus_store::open_directory_store("/path/to/store").await.unwrap();

Or use the sync wrapper:

let store = terminus_store::open_sync_directory_store("/path/to/store").unwrap();

For more information, visit the documentation on docs.rs.

Roadmap

We are constantly developing terminusdb-store to make it a high quality succinct graph representation versioned datastorage layer. To help facilitate understanding of our aims for this project we have laid out a Roadmap. If you would like to assist in the development of terminusdb-store, or you think something should be added to the roadmap please contact us.

License

terminus-store is licensed under Apache 2.0.

Contributing

See CONTRIBUTING.md

See also

  • The Terminus database, for which this library was written: Website - GitHub
  • Our prolog bindings for this library: terminus_store_prolog
  • The HDT format, which the terminusdb-store layer format is based on: Website

Dependencies

~7MB
~125K SLoC