csvpp 0.5.1

Compile csv++ 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
82
83
84
85
86

//! # Error
//!
//! Error handling structs.
use crate::{ModulePath, Output};
use std::collections;
use std::error;
use std::path;

mod bad_input;
mod cell_parse_error;
mod display;
mod eval_error;
mod from;
mod parse_error;

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

pub(crate) use bad_input::BadInput;
pub(crate) use cell_parse_error::CellParseError;

#[allow(clippy::module_name_repetitions)]
pub use eval_error::EvalError;
pub(crate) type EvalResult<T> = std::result::Result<T, EvalError>;

#[allow(clippy::module_name_repetitions)]
pub use parse_error::ParseError;
pub(crate) type ParseResult<T> = std::result::Result<T, ParseError>;

/// The various kinds of errors that can occur during compilation and evaluation of a csv++
/// module.
#[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.
    EvalError {
        eval_error: Box<EvalError>,
        filename: path::PathBuf,
        position: Option<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 compiler or reading the source code.  These are typically not
    /// due to user error.
    InitError(String),

    ModuleLoadError(String),

    ModuleLoadErrors(collections::HashMap<ModulePath, Error>),

    /// An error encountered while serializing the compiled module to an object file.
    #[deprecated]
    ObjectCodeError {
        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 {}