toondb-core

Crates.iotoondb-core
lib.rstoondb-core
version0.3.4
created_at2026-01-01 03:41:15.970339+00
updated_at2026-01-08 05:51:26.610465+00
descriptionToonDB core primitives (TOON format, storage internals, transactions)
homepagehttps://toondb.dev
repositoryhttps://github.com/toondb/toondb
max_upload_size
id2015706
size734,332
Sushanth Reddy (sushanthpy)

documentation

https://docs.toondb.dev

README

toondb-core

Core types and traits for ToonDB - the LLM-native database.

Overview

toondb-core provides the foundational types, error handling, and trait definitions used throughout the ToonDB ecosystem. This crate is typically not used directly - instead, use the toondb client crate.

Features

  • Core Types: Value types, keys, and serialization primitives
  • Error Handling: Unified error types across all ToonDB crates
  • Trait Definitions: Common traits for storage backends and query execution
  • TOON Format: Token-optimized notation for LLM efficiency (40-66% fewer tokens than JSON)

Installation

[dependencies]
toondb-core = "0.2.5"

Usage

Most users should use the high-level toondb crate instead:

use toondb::Database;

let db = Database::open("./my_data")?;

Crate Structure

ToonDB is organized into several crates:

Crate Purpose
toondb High-level client API (start here)
toondb-core Core types and traits (this crate)
toondb-storage Storage engine with WAL
toondb-index HNSW vector indexing
toondb-query Query planning and execution

License

Apache-2.0 - see LICENSE for details.

Commit count: 98

cargo fmt