regular 0.1.1

Regular Expression Manipulation and Analysis
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

#![deny(
    bad_style,
    dead_code,
    improper_ctypes,
    missing_debug_implementations,
    no_mangle_generic_items,
    non_shorthand_field_patterns,
    overflowing_literals,
    path_statements,
    patterns_in_fns_without_body,
    private_in_public,
    unconditional_recursion,
    unreachable_pub,
    unused,
    unused_allocation,
    unused_comparisons,
    unused_parens,
    while_true,
    clippy::expect_used
)]
#![forbid(unsafe_code)]
#![doc = include_str!("../README.md")]

#[macro_use]
mod macros;

use anyhow::{Context, Result};

use crate::expression::Expression;
use crate::tokens::Tokenise;
use crate::tree::tree;

mod expression;
mod parse;
mod tokens;
mod tree;

/// Provides an example from the regular language described by the expression
pub fn example(expression: String) -> Result<()> {
    let example = parse(expression)
        .context("Failed to parse expression")?
        .example();
    println!("{example}");
    Ok(())
}

/// Provides a (non-exhaustive) enumeration of the members of the regular language described by the expression
pub fn enumerate(expression: String) -> Result<()> {
    for example in parse(expression)
        .context("Failed to parse expression")?
        .enumerate()
    {
        println!("{example}")
    }
    Ok(())
}

fn parse(expression: String) -> Result<Box<dyn Expression>> {
    let tokens = expression.tokenise();
    let tree = tree(tokens)?;
    let expression = parse::parse(&tree)?;
    Ok(expression)
}