perspective-viewer 4.5.0

A data visualization and analytics component, especially well-suited for large and/or streaming datasets.
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
59
60
61

// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
// ┃ This file is part of the Perspective library, distributed under the terms ┃
// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

//! Per-keystroke expression validation with stale-result rejection.
//!
//! The component owns a monotonically increasing `req_id` and increments
//! it on each keystroke. The dispatched task echoes the `req_id` back in
//! its result payload so the component can drop validations that
//! resolved out-of-order.

use perspective_client::ExprValidationError;
use perspective_js::utils::*;
use yew::prelude::*;

use crate::queries::validate_expr;
use crate::session::Session;

/// Result payload from a dispatched validation task.
#[derive(Debug, Clone)]
pub struct ExprValidation {
    /// Request id echoed from the dispatch site so the caller can drop
    /// stale results from races between rapid keystrokes.
    pub req_id: u64,
    /// `None` if the expression validated cleanly; otherwise the
    /// per-expression error returned by the engine.
    pub error: Option<ExprValidationError>,
}

/// Validate `expr` against the active table; dispatch the result back
/// through `cb` with the given `req_id`. Errors from the engine are
/// logged to the console and surfaced as `error: None` (i.e. the
/// expression is treated as valid, matching the prior in-line behavior
/// from `expression_editor.rs::SetExpr`).
pub fn validate_expression(
    session: &Session,
    cb: Callback<ExprValidation>,
    req_id: u64,
    expr: String,
) {
    let session = session.clone();
    ApiFuture::spawn(async move {
        let error = match validate_expr(&session, &expr).await {
            Ok(x) => x,
            Err(err) => {
                web_sys::console::error_1(&format!("{err:?}").into());
                None
            },
        };
        cb.emit(ExprValidation { req_id, error });
        Ok::<_, ApiError>(())
    });
}