whichtime-sys 0.1.0

Lower-level parsing engine for natural language date parsing
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

//! Parser infrastructure and locale-specific implementations.
//!
//! Parsers are responsible for identifying date expressions in text and
//! turning them into [`ParsedResult`] values before refiners run.

pub mod common;
pub mod de;
pub mod en;
pub mod es;
pub mod fr;
pub mod it;
pub mod ja;
pub mod nl;
pub mod pt;
pub mod ru;
pub mod sv;
pub mod uk;
pub mod zh;

use crate::context::ParsingContext;
use crate::error::Result;
use crate::results::ParsedResult;

/// Trait implemented by individual date/time parsers.
pub trait Parser: Send + Sync {
    /// Get a name for this parser (for debugging)
    fn name(&self) -> &'static str;

    /// Check if this parser should run on the given context
    /// This is a fast pre-filter to skip parsers that won't match
    fn should_apply(&self, context: &ParsingContext) -> bool;

    /// Parse the text and return all matches
    fn parse(&self, context: &ParsingContext) -> Result<Vec<ParsedResult>>;
}