Struct CCDB 

pub struct CCDB { /* private fields */ }

Read-only client for the Jefferson Lab Calibration and Conditions Database.

Implementations

impl CCDB

pub fn new() -> CCDBResult<Self>

Opens a read-only handle using the CCDB_CONNECTION environment variable.

Errors

This method returns an error if the environment variable is not set or the database cannot be opened.

pub fn open(path: impl AsRef<Path>) -> CCDBResult<Self>

Opens a read-only connection to an existing CCDB SQLite database file.

Errors

This method returns an error if the database cannot be opened.

pub fn connection(&self) -> MutexGuard<'_, Connection>

Returns the underlying rusqlite::Connection.

pub fn connection_path(&self) -> &str

Returns the filesystem path used to open the database.

pub fn root(&self) -> DirectoryHandle

Returns a handle to the virtual root directory.

pub fn dir(&self, path: &str) -> CCDBResult<DirectoryHandle>

Resolves an absolute or relative directory path into a handle.

Errors

This method returns an error if the directory cannot be found.

pub fn table(&self, path: &str) -> CCDBResult<TypeTableHandle>

Resolves a table path (“/dir/name”) into a handle.

Errors

This method returns an error if the table cannot be found.

pub fn variation(&self, name: &str) -> CCDBResult<VariationMeta>

Loads variation metadata, caching repeated lookups.

Errors

This method returns an error if the variation cannot be found.

pub fn variation_chain( &self, start: &VariationMeta, ) -> CCDBResult<Vec<VariationMeta>>

Resolves a variation chain from the given starting variation up to the root.

Errors

This method returns an error if any of the variations cannot be found.

pub fn request( &self, request_string: &str, ) -> CCDBResult<BTreeMap<RunNumber, Data>>

Parses a request string of the form “/path:run:variation:timestamp” (see Request) and fetches data.

Errors

This method returns an error if the request string cannot be parsed, the parsed table path does not exist, or an error occurs while fetching data.

pub fn fetch( &self, path: &str, ctx: &CCDBContext, ) -> CCDBResult<BTreeMap<RunNumber, Data>>

Fetches data for a table path using the supplied CCDBContext.

Errors

This method returns an error if the parsed table path does not exist or an error occurs while fetching data.

Trait Implementations

impl Clone for CCDB

fn clone(&self) -> CCDB

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CCDB

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

Formats the value using the given formatter.