vantage-vista 2.0.0

Universal, schema-bearing data handle for the Vantage data framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

//! The quicksearch rule over a row held in memory.

use ciborium::Value as CborValue;
use vantage_types::Record;

use super::cell_get;
use crate::metadata::VistaMetadata;

/// Whether `row` matches the search `needle`: a case-insensitive substring
/// of the text of a cell it searches. An empty needle matches every row.
///
/// The cells searched are those of [`VistaMetadata::search_columns`], read by
/// [`cell_get`]. Metadata that declares no columns searches every cell of
/// the row.
///
/// A driver searches server-side with a cast to text, so it also finds a
/// number, a bool, a record id and a field of an embedded object. This rule
/// reads the same values, so a table behaves alike whichever side
/// evaluates the search:
///
/// - text, integers, floats and bools are read as their text;
/// - a tag (a SurrealDB record id is `Tag(8, [table, key])`) is read
///   through to its content;
/// - arrays and maps are read item by item, map values only, at any depth;
/// - null and bytes hold no text.
pub(super) fn matches_search(
    needle: &str,
    row: &Record<CborValue>,
    metadata: &VistaMetadata,
) -> bool {
    let needle = needle.to_lowercase();
    if needle.is_empty() {
        return true;
    }
    if metadata.columns.is_empty() {
        return row.values().any(|cell| contains(cell, &needle));
    }
    metadata
        .search_columns()
        .into_iter()
        .filter_map(|column| cell_get(row, column, metadata))
        .any(|cell| contains(cell, &needle))
}

/// Whether `needle`, already lower case, is in the text of `value` or of
/// anything it holds.
fn contains(value: &CborValue, needle: &str) -> bool {
    match value {
        CborValue::Text(s) => s.to_lowercase().contains(needle),
        CborValue::Integer(i) => i128::from(*i).to_string().contains(needle),
        CborValue::Float(f) => f.to_string().contains(needle),
        CborValue::Bool(b) => b.to_string().contains(needle),
        CborValue::Tag(_, inner) => contains(inner, needle),
        CborValue::Array(items) => items.iter().any(|item| contains(item, needle)),
        CborValue::Map(entries) => entries.iter().any(|(_, v)| contains(v, needle)),
        _ => false,
    }
}