// ZPWR-CRATE — SHARED SAMPLE-LIBRARY CRATE BROWSER

Two consumers, one library

Schema versions match Audio-Haxor's migration numbers, so opening an existing Audio-Haxor database is a no-op — it is already past those versions.

Scan · Index · Browse

Native (Rust) usage

Audio-Haxor links the rlib and calls the API directly. scan drives the walk + index; Database::crate_query serves the browse side.

use std::sync::Arc;
use std::sync::atomic::AtomicBool;
use zpwr_crate::{Database, CrateQueryParams, scan};

let db = Database::open(std::path::Path::new("/path/to/crate.db"))?;
let roots = vec![std::path::PathBuf::from("/Users/me/Samples")];
let n = scan(&db, &roots, Arc::new(AtomicBool::new(false)), None, |total| {
    println!("inserted {total}");
})?;

let res = db.crate_query(&CrateQueryParams {
    category: Some("Drums".into()),
    bpm_min: Some(120),
    bpm_max: Some(130),
    limit: 200,
    ..Default::default()
})?;
println!("{} of {}", res.rows.len(), res.total);

CrateQueryParams::limit defaults to 200 only when deserialized from JSON (the FFI path); native callers constructing the struct should set limit themselves.

C ABI usage (zpwr-daw)

zpwr-daw links libzpwr_crate.a (or the cdylib) and includes include/zpwr_crate.h — hand-written, no cbindgen. Structured data crosses as UTF-8 JSON.

#include "zpwr_crate.h"

CrateHandle *h = crate_open("/path/to/crate.db");
crate_scan(h, "[\"/Users/me/Samples\"]", NULL, NULL);

char *json = crate_query(h, "{\"category\":\"Drums\",\"limit\":200}");
/* ... parse json ... */
crate_string_free(json);

crate_free(h);

Every returned char* is owned by Rust — release it with crate_string_free. Release the handle with crate_free.

C ABI surface

Storage & schema

Build & test

cargo build          # produces rlib + staticlib + cdylib
cargo test           # headless; scans temp dirs, exercises the query layer
cargo fmt --all --check
cargo clippy --all-targets -- -D warnings

Builds and tests on Linux x86_64 and macOS aarch64 (CI covers both). rusqlite is bundled, so no system SQLite is required.

Source layout

The audio stack

zpwr-crate is the shared data layer of the MenkeTechnologies audio applications. Browse the rest via the MenkeTechnologiesMeta umbrella repo:

• Audio-Haxor — Tauri v2 desktop app; links zpwr-crate as an rlib
• zpwr-daw — DAW arranger + the 4th patch-graph plugin; links the C ABI
• zpwr-synth — JUCE modular patch-graph synthesizer
• zpwr-fx — JUCE modular multi-effects plugin
• zpwr-midi-fx — JUCE modular MIDI-effects plugin
• zpwr-patch-core — signal-agnostic modular patch graph