yabfi 1.0.1

Yet another brainfuck interpreter.
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

use std::error::Error;

use nom::Finish;

use super::parser;
use super::prelude::*;

/// Parses brainfuck code.
///
/// If you just want to run this code, see [run].
///
/// If you need more lower level control over parsing, see the [parser] module.
///
/// On success, returns parsed [expressions](parser::Expression).
pub fn parse(code: &str) -> Result<Vec<Expression>, ParseError> {
    match parser::parse(code).finish() {
        Ok(parse_result) => Ok(parse_result.1),
        Err(e) => Err(e.into()),
    }
}

/// Parses and runs brainfuck code.
///
/// By default, this function uses stdin and stdout for the `,` and `.` commands.
/// To change this, use [run_with_io].
///
/// If you need more lower level control, see [Context] and [parse].
///
/// On success, this returns the leftover bytes on the tape.
pub fn run<'a>(code: &'a str) -> Result<Vec<u8>, BfError<'a, std::io::Error>> {
    run_with_io(code, &mut std::io::stdin(), &mut std::io::stdout())
}

/// Parses and runs brainfuck code.
///
/// Uses `in_stream` and `out_stream` for the `,` and `.` commands.
///
/// If you need more lower level control, see [Context] and [parse].
///
/// On success, this returns the leftover bytes on the tape.
pub fn run_with_io<'a, IoErr: Error>(
    code: &'a str,
    in_stream: &mut dyn BfInStream<IoErr>,
    out_stream: &mut dyn BfOutStream<IoErr>,
) -> Result<Vec<u8>, BfError<'a, IoErr>> {
    let exps = parse(code)?;
    let mut context = Context::new();
    context.eval_many(&exps, in_stream, out_stream)?;
    Ok(context.data)
}