oak-dsv 0.0.11

High-performance incremental DSV (Delimiter-Separated Values) parser for the oak ecosystem with flexible configuration, optimized for data parsing and tabular data processing.
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

#![doc = include_str!("readme.md")]
use crate::{lexer::token_type::DsvTokenType, parser::element_type::DsvElementType};
use oak_core::{Language, LanguageCategory};
#[cfg(feature = "serde")]
mod deserializer;
#[cfg(feature = "serde")]
mod serializer;
#[cfg(feature = "serde")]
pub use deserializer::from_value;
#[cfg(feature = "serde")]
pub use serializer::to_value;

/// DSV language implementation for the Oaks framework.
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, std::marker::ConstParamTy)]
pub struct DsvLanguage {
    /// Field separator, defaults to comma (`,`).
    pub field_separator: char,
    /// Quote character, defaults to double quote (`"`).
    pub quote_char: char,
}

impl Default for DsvLanguage {
    fn default() -> Self {
        Self { field_separator: ',', quote_char: '"' }
    }
}

impl DsvLanguage {
    /// Sets the field separator.
    pub const fn with_separator(mut self, separator: char) -> Self {
        self.field_separator = separator;
        self
    }

    /// Sets the quote character.
    pub const fn with_quote_char(mut self, quote: char) -> Self {
        self.quote_char = quote;
        self
    }
}

/// DSV language marker with configuration.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct Dsv<const L: DsvLanguage>;

impl<const L: DsvLanguage> Language for Dsv<L> {
    const NAME: &'static str = "dsv";
    const CATEGORY: LanguageCategory = LanguageCategory::Config;

    type TokenType = DsvTokenType;
    type ElementType = DsvElementType;
    type TypedRoot = crate::ast::DsvRoot<L>;
}