rust-bf 0.4.0

A Brainfuck interpreter, generator, REPL, and IDE written in Rust
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

use clap::{Parser, Subcommand};
use std::env;
use std::io::{self, Write};
use std::path::PathBuf;

fn print_top_usage_and_exit(program: &str, code: i32) -> ! {
    eprintln!(
        r#"Usage:
  {0} read  [--debug|-d] "<code>"      # Run Brainfuck code (args are concatenated)
  {0} read  [--debug|-d] --file <PATH> # Run Brainfuck code loaded from file
  {0} write [--bytes] [TEXT...]        # Generate Brainfuck to print TEXT/STDIN/file
  {0} write [--bytes] --file <PATH>    # Generate Brainfuck to print file contents
  {0} repl                             # Start a Brainfuck REPL (read-eval-print loop)
  {0} ide   [--file <PATH>]            # Start a terminal-based Brainfuck IDE, optionally loading a file

Run "{0} <subcommand> --help" for more info.
"#,
        program
    );
    let _ = io::stderr().flush();
    std::process::exit(code);
}

#[derive(Parser, Debug)]
#[command(name = "bf", disable_help_flag = true, disable_help_subcommand = true)]
struct Cli {
    /// Show this help
    #[arg(short = 'h', long = "help", action = clap::ArgAction::SetTrue)]
    help: bool,

    #[command(subcommand)]
    command: Option<Command>,
}

#[derive(Subcommand, Debug)]
enum Command {
    Read(rust_bf::commands::read::ReadArgs),
    Write(rust_bf::commands::write::WriteArgs),
    Repl(rust_bf::commands::repl::ReplArgs),
    Ide(rust_bf::commands::ide::IdeArgs),
}

fn main() {
    // We still pull the program name for help rendering consistency
    let program = env::args().next().unwrap_or_else(|| String::from("bf"));

    let cli = Cli::parse();
    
    if cli.help {
        print_top_usage_and_exit(&program, 0);
    }

    let code = match cli.command {
        Some(Command::Read(args)) => rust_bf::commands::read::run(&program, args),
        Some(Command::Write(args)) => rust_bf::commands::write::run(&program, args),
        Some(Command::Repl(args)) => {
            let program = "repl";
            let mode_flag = if args.bare {
                rust_bf::repl::ModeFlagOverride::Bare
            } else if args.editor {
                rust_bf::repl::ModeFlagOverride::Editor
            } else {
                rust_bf::repl::ModeFlagOverride::None
            };
            
            let code = rust_bf::commands::repl::run(&program, false, mode_flag);
            std::process::exit(code);
        },
        Some(Command::Ide(args)) => {
            let filename = if let Some(filename) = &args.filename {
                if args.help {
                    eprintln!("Error: --help cannot be used with --file");
                    std::process::exit(1);
                }
                Some(PathBuf::from(filename))
            } else {
                None
            };

            rust_bf::commands::ide::run(&program, args.help, filename, args.vi_mode)
        }
        None => {
            // Default to REPL when no subcommand is provided
            rust_bf::commands::repl::run(&program, false, rust_bf::repl::ModeFlagOverride::None)
        }
    };

    std::process::exit(code);
}