Struct SqliteBackend 

pub struct SqliteBackend { /* private fields */ }

SQLite backend for experiment storage

Uses a real SQLite database (WAL mode) for durable, per-project experiment tracking. The database is created lazily at <project>/.entrenar/experiments.db.

The Connection is wrapped in a Mutex to satisfy the Send + Sync bounds on ExperimentStorage. SQLite in WAL mode handles concurrent readers natively; the mutex serializes writers.

Implementations

impl SqliteBackend

pub fn get_artifact_data(&self, sha256: &str) -> Result<Vec<u8>>

Get artifact data by SHA-256 hash

pub fn list_artifacts(&self, run_id: &str) -> Result<Vec<ArtifactRef>>

List artifacts for a run

impl SqliteBackend

pub fn open<P: AsRef<Path>>(path: P) -> Result<Self>

Open or create a SQLite database at the given path

pub fn open_in_memory() -> Result<Self>

Open an in-memory database (for tests — backward compatible)

pub fn open_project<P: AsRef<Path>>(project_dir: P) -> Result<Self>

Open or create at project-local path: <project>/.entrenar/experiments.db

pub fn path(&self) -> &str

Get the database path

impl SqliteBackend

pub fn log_param( &self, run_id: &str, key: &str, value: ParameterValue, ) -> Result<()>

Log a parameter for a run

pub fn log_params( &self, run_id: &str, params_map: HashMap<String, ParameterValue>, ) -> Result<()>

Log multiple parameters for a run

pub fn get_params( &self, run_id: &str, ) -> Result<HashMap<String, ParameterValue>>

Get parameters for a run

pub fn search_runs_by_params(&self, filters: &[ParamFilter]) -> Result<Vec<Run>>

Search runs by parameter filters

pub fn get_experiment(&self, experiment_id: &str) -> Result<Experiment>

Get an experiment by ID

pub fn get_run(&self, run_id: &str) -> Result<Run>

Get a run by ID

pub fn list_experiments(&self) -> Result<Vec<Experiment>>

List all experiments

pub fn list_runs(&self, experiment_id: &str) -> Result<Vec<Run>>

List runs for an experiment

Trait Implementations

impl Debug for SqliteBackend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ExperimentStorage for SqliteBackend

fn create_experiment( &mut self, name: &str, config: Option<Value>, ) -> Result<String>

Create a new experiment

fn create_run(&mut self, experiment_id: &str) -> Result<String>

Create a new run within an experiment

fn start_run(&mut self, run_id: &str) -> Result<()>

Start a run, transitioning from Pending to Running

fn complete_run(&mut self, run_id: &str, status: RunStatus) -> Result<()>

Complete a run with the given status

fn log_metric( &mut self, run_id: &str, key: &str, step: u64, value: f64, ) -> Result<()>

Log a metric value for a run

fn log_artifact( &mut self, run_id: &str, key: &str, data: &[u8], ) -> Result<String>

Log an artifact for a run

fn get_metrics(&self, run_id: &str, key: &str) -> Result<Vec<MetricPoint>>

Get metrics for a specific run and key

fn get_run_status(&self, run_id: &str) -> Result<RunStatus>

Get the current status of a run

fn set_span_id(&mut self, run_id: &str, span_id: &str) -> Result<()>

Set renacer span ID for distributed tracing

fn get_span_id(&self, run_id: &str) -> Result<Option<String>>

Get renacer span ID for a run