atomic-lib

Status: Beta. Changelog

Rust library for using Atomic Data.

Docs

The atomic CLI and atomic-server applications both use this atomic-lib library.

[x] In-memory store for getting / setting data (Store)
[x] On disk ACID compliant store / database (Db, uses Sled)
[x] [Path](https://docs.atomicdata.dev/core/paths.html) traversal
[x] Parse and serialize AD3
[x] JSON + JSON-LD Serialization
[x] Convert to Rust native types
[x] Resolve / parse mappings (bookmarks)
[x] Validate Atomic Graphs
[x] Mutations (linked-delta's)
[x] RDF (turtle / N-Triples) Serialization
[ ] Strategy for extending datatypes (Currently uses an enum)
[x] TPF queries
[ ] Performant TPF queries from Db (create index)
[ ] Async resource fetching (faster)
[ ] Store - server write interaction (update resource, send deltas to server)

Usage

```sh

Add it to your project

cargo add atomic_lib ```

```rs use atomic_lib;

fn main() { // Let's parse this AD3 string let string = String::from(r#"[":test","https://atomicdata.dev/properties/shortname","Test"]"#); // Start with initializing our store let mut store = atomiclib::store::Store::init(); // Run parse... store.parsead3(&string).unwrap(); // Get our resource... let myresource = store.get(&":test".into()).unwrap(); // Get our value by filtering on our property... let myvalue = myresource.get("https://atomicdata.dev/properties/shortname").unwrap(); println!("My value: {}", myvalue); assert!(my_value == "Test") } ```

Optional features

Some features of this library are optional, to minimize bundle size and compile times.

The db features adds persistence, which means that you can store stuff on an HDD / SSD. It uses [Sled], a performant, embedded key-value store.

rdf

If you need RDF serialization options (Turtle / N-Triples), use this feature.