Struct Views 

pub struct Views { /* private fields */ }

The saved views, read on a worker from run’s start (a directory parse that can stall on slow mounts). Nothing needs them until a schema is known (--view, auto-apply) or the list opens; first use waits if still reading, so a requested view is never skipped. Derefs to the ViewManager.

Implementations

impl Views

pub fn read_in_background() -> Self

Start reading the views on a worker.

Methods from Deref<Target = ViewManager>

pub fn load_views(&mut self) -> Result<()>

pub fn save_view(&self, view: &SavedView) -> Result<()>

Write view as it is, under the lock and by rename: a crash or a reader mid-write never meets a half-written view.

pub fn delete_view(&mut self, id: &str) -> Result<()>

pub fn record_use(&mut self, id: &str, file: &Path) -> Result<()>

Count a use of the view by bumping its stored file (not writing this copy back), so other instances’ edits and deletions survive.

pub fn find_relevant_views<'a>( &self, dataset: impl Into<Dataset<'a>>, schema: &Schema, ) -> Vec<(SavedView, f64)>

pub fn get_most_relevant<'a>( &self, dataset: impl Into<Dataset<'a>>, schema: &Schema, ) -> Option<(SavedView, MatchReason)>

The best view whose own criteria match this file, not the best-scored (usage and recency would make the most-used view “match” everything).

pub fn suggest_name(&self, path: Option<&Path>, query: Option<&str>) -> String

A recognizable name for a view saved from this state: the file stem, else the query’s first words; numbered past the first collision.

pub fn view_exists(&self, name: &str) -> bool

pub fn get_view_by_name(&self, name: &str) -> Option<&SavedView>

pub fn get_view_by_id(&self, id: &str) -> Option<&SavedView>

pub fn all_views(&self) -> &[SavedView]

pub fn create_view( &mut self, name: String, description: Option<String>, match_criteria: MatchCriteria, settings: ViewSettings, ) -> Result<SavedView>

pub fn update_view(&mut self, edited: &SavedView) -> Result<()>

Save an edit of a view: only what changed from this instance’s copy, over the stored view, so other instances’ edits and usage survive. A view deleted elsewhere is an error and leaves this instance too.

pub fn remove_all_views(&mut self) -> Result<()>

Trait Implementations

impl Deref for Views

type Target = ViewManager

The resulting type after dereferencing.

fn deref(&self) -> &ViewManager

Dereferences the value.

impl DerefMut for Views

fn deref_mut(&mut self) -> &mut ViewManager

Mutably dereferences the value.

impl From<ViewManager> for Views

fn from(manager: ViewManager) -> Self

Converts to this type from the input type.