csvpp 0.4.1

Compile csvpp source code to a target spreadsheet format
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! # Error
//!
//! Error handling structs.
use crate::Output;
use std::error;
use std::path;

mod bad_input;
mod display;
mod eval_error;
mod modifier_parse_error;
mod parse_error;

pub use parse_error::ParseError;
pub type Result<T> = std::result::Result<T, Error>;

pub(crate) use bad_input::BadInput;
pub(crate) use eval_error::EvalError;
pub(crate) use modifier_parse_error::ModifierParseError;

pub(crate) type ParseResult<T> = std::result::Result<T, ParseError>;
pub(crate) type EvalResult<T> = std::result::Result<T, EvalError>;

/// The various kinds of errors that can occur during compilation and evaluation of a csv++
/// template.
#[derive(Debug)]
pub enum Error {
    /// A syntax error in a formula in a cell.
    CellSyntaxError {
        filename: path::PathBuf,
        position: a1_notation::Address,
        parse_error: Box<ParseError>,
    },

    /// A syntax error in the code section.
    CodeSyntaxError {
        filename: path::PathBuf,
        parse_error: Box<ParseError>,
    },

    /// An error encountered when evaluating the formulas in a cell.  For example if a builtin
    /// funciton is called with the wrong number of arguments.
    EvalError {
        message: String,
        filename: path::PathBuf,
        position: a1_notation::Address,
    },

    /// Google Sheets requires that the `gcloud` CLI tools are installed and configured.  If we
    /// think they're not, this message includes a lot of details about setting them up.  So
    /// it's very Google Sheets-specific.
    GoogleSetupError(String),

    /// An error while building the runtime or reading the source code.  These are typically not
    /// due to user error.
    InitError(String),

    /// A syntax error encountered while parsing the modifiers of a cell.
    ModifierSyntaxError {
        filename: path::PathBuf,
        parse_error: Box<ParseError>,
        position: a1_notation::Address,
    },

    /// An error encountered while serializing the compiled template to an object file.
    ObjectWriteError {
        filename: path::PathBuf,
        message: String,
    },

    /// An error ecountered reaading or doing an initial parse of the source code.
    SourceCodeError {
        filename: path::PathBuf,
        message: String,
    },

    /// An error encountered while writing to the target.
    TargetWriteError { message: String, output: Output },
}

impl error::Error for Error {}