etcd_txn_parser/
lib.rs

1#![doc = include_str!("../Readme.md")]
2use crate::compare::Compare;
3use crate::operation::Operation;
4use elyze::bytes::matchers::match_pattern;
5use elyze::bytes::primitives::whitespace::OptionalWhitespaces;
6use elyze::bytes::token::Token;
7use elyze::errors::{ParseError, ParseResult};
8use elyze::matcher::Match;
9use elyze::peek::{peek, Until, UntilEnd};
10use elyze::recognizer::recognize;
11use elyze::scanner::Scanner;
12use elyze::separated_list::SeparatedList;
13use elyze::visitor::Visitor;
14
15pub mod compare;
16pub mod operation;
17
18/// Parse a transactional data structure from a byte slice.
19///
20/// # Errors
21///
22/// If the parser encounters an unexpected token, a `ParseError` is returned.
23///
24/// # Examples
25///
26///
27pub fn parse(data: &[u8]) -> ParseResult<TxnData> {
28    TxnData::accept(&mut Scanner::new(data))
29}
30
31/// A transactional data structure.
32#[derive(Debug, PartialEq)]
33pub struct TxnData<'a> {
34    /// A list of operations to compare against the current state.
35    pub compares: Vec<Compare<'a>>,
36    /// A list of operations to apply if the compare operations pass.
37    pub success: Vec<Operation<'a>>,
38    /// A list of operations to apply if the compare operations fail.
39    pub failure: Vec<Operation<'a>>,
40}
41
42struct LineFeed;
43
44impl<'a> Visitor<'a, u8> for LineFeed {
45    fn accept(scanner: &mut Scanner<'a, u8>) -> ParseResult<Self> {
46        recognize(Token::Ln, scanner)?;
47        Ok(LineFeed)
48    }
49}
50
51#[derive(Clone)]
52struct SectionEnd;
53
54impl Match<u8> for SectionEnd {
55    fn is_matching(&self, data: &[u8]) -> (bool, usize) {
56        match_pattern(b"\n\n", data)
57    }
58
59    fn size(&self) -> usize {
60        2
61    }
62}
63
64impl<'a> Visitor<'a, u8> for TxnData<'a> {
65    fn accept(scanner: &mut Scanner<'a, u8>) -> ParseResult<Self> {
66        OptionalWhitespaces::accept(scanner)?;
67
68        // Read the compare section
69        let section_compare =
70            peek(Until::new(SectionEnd), scanner)?.ok_or(ParseError::UnexpectedToken)?;
71        let mut section_compare_scanner = Scanner::new(section_compare.data);
72        let compares =
73            SeparatedList::<u8, Compare, LineFeed>::accept(&mut section_compare_scanner)?.data;
74        scanner.bump_by(section_compare.end_slice);
75
76        LineFeed::accept(scanner)?;
77        LineFeed::accept(scanner)?;
78
79        // Read the success section
80        let section_success =
81            peek(Until::new(SectionEnd), scanner)?.ok_or(ParseError::UnexpectedToken)?;
82
83        let mut section_success_scanner = Scanner::new(section_success.data);
84        let success =
85            SeparatedList::<u8, Operation, LineFeed>::accept(&mut section_success_scanner)?.data;
86        scanner.bump_by(section_success.end_slice);
87
88        LineFeed::accept(scanner)?;
89        LineFeed::accept(scanner)?;
90
91        // Read the failure section
92        let section_failure =
93            peek(UntilEnd::default(), scanner)?.ok_or(ParseError::UnexpectedToken)?;
94
95        let mut section_failure_scanner = Scanner::new(section_failure.data);
96        let failure =
97            SeparatedList::<u8, Operation, LineFeed>::accept(&mut section_failure_scanner)?.data;
98
99        Ok(TxnData {
100            compares,
101            success,
102            failure,
103        })
104    }
105}
etcd_txn_parser/lib.rs

etcd_txn_parser/
lib.rs
