atomic-lib

[![Discord chat][discord-badge]][discord-url]

Status: pre-alpha

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("[\":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") } ```

Features

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

db

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

rdf

If you need RDF serialization options, use this feature.