Goto buffer by num

book/src/generated/typable-cmd.md

@@ -11,6 +11,9 @@
 | `:buffer-close-all!`, `:bca!`, `:bcloseall!` | Force close all buffers ignoring unsaved changes without quitting. |
 | `:buffer-next`, `:bn`, `:bnext` | Goto next buffer. |
 | `:buffer-previous`, `:bp`, `:bprev` | Goto previous buffer. |
+| `:buffer-index`, `:bi` | Goto buffer by number <n>. |
+| `:buffer-first`, `:bf` | Goto first buffer. |
+| `:buffer-last`, `:bl` | Goto last buffer. |
 | `:write`, `:w` | Write changes to disk. Accepts an optional path (:write some/path.txt) |
 | `:write!`, `:w!` | Force write changes to disk creating necessary subdirectories. Accepts an optional path (:write! some/path.txt) |
 | `:write-buffer-close`, `:wbc` | Write changes to disk and closes the buffer. Accepts an optional path (:write-buffer-close some/path.txt) |

helix-term/src/commands/typed.rs

@@ -325,6 +325,61 @@ fn buffer_previous(
     Ok(())
 }
 
+fn buffer_first(
+    cx: &mut compositor::Context,
+    _args: &[Cow<str>],
+    event: PromptEvent,
+) -> anyhow::Result<()> {
+    if event != PromptEvent::Validate {
+        return Ok(());
+    }
+    match cx.editor.documents.keys().nth(0) {
+        Some(doc_id) => cx.editor.switch(*doc_id, Action::Replace),
+        None => bail!("The first buffer not found"),
+    }
+    Ok(())
+}
+
+fn buffer_last(
+    cx: &mut compositor::Context,
+    _args: &[Cow<str>],
+    event: PromptEvent,
+) -> anyhow::Result<()> {
+    if event != PromptEvent::Validate {
+        return Ok(());
+    }
+    match cx.editor.documents.keys().last() {
+        Some(doc_id) => cx.editor.switch(*doc_id, Action::Replace),
+        None => bail!("The last buffer not found"),
+    }
+    Ok(())
+}
+fn buffer_index(
+    cx: &mut compositor::Context,
+    args: &[Cow<str>],
+    event: PromptEvent,
+) -> anyhow::Result<()> {
+    if event != PromptEvent::Validate {
+        return Ok(());
+    }
+    if args.is_empty() {
+        bail!("At least one index must be provided");
+    } else if args.len() > 1 {
+        bail!("Only one index must be provided");
+    }
+    let mut index = args[0].parse::<usize>()?;
+    if index == 0 {
+        bail!("The index must be greater than 0");
+    }
+
+    let mut document_keys = cx.editor.documents.keys();
+    if index > document_keys.len() {
+        index = document_keys.len()
+    }
+    let doc_id = document_keys.nth(index - 1).unwrap();
+    cx.editor.switch(*doc_id, Action::Replace);
+    Ok(())
+}
 fn write_impl(
     cx: &mut compositor::Context,
     path: Option<&Cow<str>>,
@@ -2369,6 +2424,27 @@ pub const TYPABLE_COMMAND_LIST: &[TypableCommand] = &[
         fun: buffer_previous,
         signature: CommandSignature::none(),
     },
+    TypableCommand {
+        name: "buffer-index",
+        aliases: &["bi"],
+        doc: "Goto buffer by number <n>.",
+        fun: buffer_index,
+        signature: CommandSignature::none(),
+    },
+    TypableCommand {
+        name: "buffer-first",
+        aliases: &["bf"],
+        doc: "Goto first buffer.",
+        fun: buffer_first,
+        signature: CommandSignature::none(),
+    },
+    TypableCommand {
+        name: "buffer-last",
+        aliases: &["bl"],
+        doc: "Goto last buffer.",
+        fun: buffer_last,
+        signature: CommandSignature::none(),
+    },
     TypableCommand {
         name: "write",
         aliases: &["w"],