- Notifications
You must be signed in to change notification settings - Fork33
a tokio-enabled data store for triple data
License
terminusdb/terminusdb-store
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
This library implements a way to store triple data - data thatconsists of a subject, predicate and an object, where object caneither be some value, or a node (a string that can appear both insubject 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).
Incow says value(moo)
,cow
is the subject,says
is thepredicate, andvalue(moo)
is the object.
Incow likes node(duck)
,cow
is the subject,likes
is thepredicate, andnode(duck)
is the object.
terminusdb-store allows you to store a lot of such facts, and searchthrough them efficiently.
This library is intended as a common base for anyone who wishes tobuild a database containing triple data. It makes very few assumptionson what valid data is, only focusing on the actual storage aspect.
This library is tokio-enabled. Any i/o and locking happens throughfutures, and as a result, many of the functions in this library returnfutures. These futures are intended to run on a tokio runtime, andmany of them will fail outside of one. If you do not wish to usetokio, there's a small sync wrapper instore::sync
which embeds itsown tokio runtime, exposing a purely synchronous API.
Add this to yourCargo.toml
:
[dependencies]terminus-store ="0.19.2"
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.
See also theexamples/
directory for some basic examples.
Starting with version 0.20.0, terminus-store uses a new storage format, which bundles all files into a single archive, and also supports value types. Stores created using 0.19 or earlier will not work with 0.20 or later. However, there is a conversion tool to convert existing pre-v20 stores:terminusdb-10-to-11.
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 aRoadmap. 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.
terminus-store is licensed under Apache 2.0.
- 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
About
a tokio-enabled data store for triple data
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Uh oh!
There was an error while loading.Please reload this page.
Contributors9
Uh oh!
There was an error while loading.Please reload this page.