termi 0.1.0

A modal terminal code editor written in Rust
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

//! # Commands
//!
//! **Purpose:** the vocabulary of the `:` command line.
//!
//! **Responsibility:** define what a command *is*. Turning text into a
//! [`Command`] happens in [`parser`]; carrying one out happens in the
//! application layer. Keeping the enum here means the parser and the executor
//! cannot drift apart — adding a variant breaks both until both are updated.
//!
//! **Public API:** [`Command`].

pub mod parser;

use std::path::PathBuf;

/// A parsed command line.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum Command {
    /// `:w [path]` — write the buffer.
    Write(Option<PathBuf>),
    /// `:q[!]` — close the buffer, or the editor when it is the last one.
    Quit { force: bool },
    /// `:wq` / `:x` — write and quit.
    WriteQuit { force: bool },
    /// `:e[!] path` — open a file; `force` discards unsaved changes.
    Edit { path: PathBuf, force: bool },
    /// `:e!` with no path — reload the current file from disk.
    Reload,
    /// `:42` — jump to a line.
    GotoLine(usize),
    /// `:set key value` — change a setting for this session.
    Set { key: String, value: String },
    /// `:theme name` — switch colour scheme.
    Theme(String),
    /// `:bn` / `:bp` — switch buffers.
    CycleBuffer { forward: bool },
    /// `:%s/pattern/replacement/[g]` — substitute.
    Substitute {
        /// Search pattern, interpreted according to the search settings.
        pattern: String,
        /// Replacement text.
        replacement: String,
        /// Replace every match on a line rather than the first.
        all: bool,
        /// Apply to the whole document rather than the current line.
        whole_file: bool,
    },
    /// `:help` — list the commands.
    Help,
}