add-ed 0.9.0-alpha7

//! Add-Ed is a library implementing the parsing and runtime for Ed in rust.
//!
//! It exports two traits, Buffer and UI, which define the exchangeable parts of the editor.
//!
//! An implementation of the UI trait is needed to support the 'g' command and similar, DummyUI.
//! It is used for macro execution, by taking prepared input from a input list rather than prompting the user.
//!
//! Since the buffer is rather complex a standard Buffer implementation is included in the feature "vecbuffer".
//! It is recommended to compare the behaviour of any Buffer implementation to the VecBuffer in addition to the api tests.
//!
//! An example of how to use this library is in src/bin/classic.rs

use std::collections::HashMap;

pub mod error_consts;
mod cmd;

pub mod ui;
pub mod buffer;

use ui::UI;
use buffer::Buffer;

/// A small reference struct that gives insight into the editor's state
pub struct EdState<'a> {
  pub selection: (usize, usize),
  pub buffer: &'a dyn Buffer,
  pub path: &'a str,
}

/// A ready parsed 's' invocation
struct Substitution {
  pattern: String,
  substitute: String,
  global: bool,
  p: bool,
  n: bool,
  l: bool,
}

/// The state variable used by the editor to track its internal state
pub struct Ed <'a, B: Buffer> {
  // Track the currently selected lines in the buffer
  // This is usually separate from viewed lines in the UI
  selection: (usize, usize),
  // A mutable reference to a Buffer implementor
  // The buffer implementor will handle most of the operations and store the data
  buffer: &'a mut B,
  // The path to the currently selected file
  path: String,
  // The previous search_replace's arguments, to support repeating the last
  prev_s: Option<Substitution>,
  // Flag to prevent auto-creating undo-points when running macros or the like
  dont_snapshot: bool,

  // Prefix for command input. Traditionally ':' so that by default
  cmd_prefix: Option<char>,
  // Default states for printing flags
  // Allows to print numbered or literal by default
  n: bool,
  l: bool,
  // Map of macro name to macro script
  macros: HashMap<String, String>,
  // Wether or not to print errors when they occur (if not, print ? instead of error)
  print_errors: bool,
  // The previous error that occured, since we may not have printed it
  error: Option<&'static str>,
}

impl <'a, B: Buffer> Ed <'a, B> {
  /// Construct a new instance of Ed
  ///
  /// * An empty file string is recommended if no filepath is opened
  /// * Note that you _can_ initialise the buffer with contents before this, but
  ///   those contents will be overwritten if a path is given.
  /// * macros behave like scripts given to the 'g' command
  ///   an example is "a\n\n.\n" which appends an empty line
  pub fn new(
    buffer: &'a mut B,
    path: String,
    macros: HashMap<String, String>,
    n: bool,
    l: bool,
  ) -> Result<Self, &'static str> {
    if ! path.is_empty() {
      buffer.read_from(&path, None, false)?;
    }
    let selection = (1,0); // Empty, but that is handled in cmd module
    let tmp = Self {
      // Sane defaults for initial settings
      print_errors: true,
      error: None,
      prev_s: None,
      cmd_prefix: Some(':'),
      selection,
      dont_snapshot: false,
      // And the given values
      buffer,
      path,
      n,
      l,
      macros,
    };
    Ok(tmp)
  }

  /// Run the given command
  ///
  /// Returns true if the command was to quit
  pub fn run_command(
    &mut self,
    ui: &mut dyn UI,
    command: &str,
  ) -> Result<bool, &'static str> {
    // Just hand execution into the cmd module
    match cmd::run(self, ui, command) {
      // If error, note it in state
      Err(e) => {
        self.error = Some(e);
        Err(e)
      },
      x => x,
    }
  }

  /// Run given instance of Ed until it receives a command to quit or errors
  ///
  /// The returned error type could be improved, suggestions welcome.
  pub fn run_macro(
    &mut self,
    ui: &mut dyn UI,
  ) -> Result<(), &'static str> {
    // Loop until quit or error
    loop {
      let cmd = match ui.get_command( self.see_state(), self.cmd_prefix ) {
        Err(e) => { self.error = Some(e); return Err(e) },
        Ok(x) => x,
      };
      if self.run_command(ui, &cmd)? {
        break;
      }
    }
    Ok(())
  }
  pub fn run(
    &mut self,
    ui: &mut dyn UI,
  ) -> Result<(), &'static str> {
    loop {
      match self.run_macro(ui) {
        Ok(()) => break,
        Err(e) => {
          if self.print_errors {
            ui.print_message(e)?;
          }
          else {
            ui.print_message("?\n")?;
          }
        },
      }
    }
    Ok(())
  }

  /// Get an immutable reference to part of the editors state
  pub fn see_state(&self) -> EdState {
    EdState{
      selection: self.selection,
      path: &self.path,
      buffer: self.buffer,
    }
  }
}