pups_text 0.1.15

Pretty Understandable Parsers
Documentation
// Copyright Rob Gage 2025

use crate::{
    Character,
    TextInput
};
use pups_core::{
    implement_modes,
    Input,
    Mode,
    ModeResult::{
        self,
        Failure,
        Success,
    },
    Parser
};

/// Parses whitespace
struct Whitespace;

impl<'a, C, I> Parser<'a, I::Slice, (), (), I> for Whitespace
where
    C: Character,
    I: Input<'a, Item = C> + TextInput,
{

    fn apply<_Mode: Mode>(
        &self,
        input: &'a I
    ) -> ModeResult<I::Slice , (), (), _Mode> {
        let start: usize = input.store_cursor();
        loop {
            if let Some (character) = input.peek() && character.is_whitespace() {
                input.advance();
            } else { break };
        }
        let end: usize = input.store_cursor();
        if end - start > 0 {
            Success (
                _Mode::convert_output(input.slice(start, end)),
                _Mode::new_message_container()
            )
        } else {
            input.move_cursor(start);
            Failure (_Mode::convert_error(()), _Mode::new_message_container())
        }
    }

    implement_modes!('a, I::Slice, (), (), I);

}

/// Parses whitespace
pub const fn whitespace<'a, C, I>() -> impl Parser<'a, I::Slice, (), (), I>
where
    C: Character,
    I: Input<'a, Item = C> + TextInput,
{ Whitespace }