try-me-maybe-core 0.1.0

Core library for try-me-maybe, a Rust port of tobi/try (ephemeral workspace manager)
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

//! Global help text — byte-for-byte port of `print_global_help`
//! (`try.rb:960-1006`), with one sanctioned substitution: the version token
//! renders this package's version (ADR-0002). Printed to STDERR.

/// Render the help text with the given semver (upstream: `try v1.9.3 - …`).
#[must_use]
pub fn global_help(version: &str) -> String {
    format!(
        r#"try v{version} - ephemeral workspace manager

To use try, add to your shell config:

  # bash/zsh (~/.bashrc or ~/.zshrc)
  eval "$(try init ~/src/tries)"

  # fish (~/.config/fish/config.fish)
  eval (try init ~/src/tries | string collect)

Usage:
  try [query]           Interactive directory selector
  try clone <url>       Clone repo into dated directory
  try worktree <name>   Create worktree from current git repo
  try --help            Show this help

Commands:
  init [path]           Output shell function definition
  clone <url> [name]    Clone git repo into date-prefixed directory
  worktree <name>       Create worktree in dated directory

Examples:
  try                   Open interactive selector
  try project           Selector with initial filter
  try clone https://github.com/user/repo
  try worktree feature-branch

Manual mode (without alias):
  try exec [query]      Output shell script to eval

Environment:
  TRY_PATH          Tries directory (default: ~/src/tries)
  TRY_PROJECTS      Graduate destination (default: parent of TRY_PATH)

Keyboard:
  ↑/↓, Ctrl-P/N     Navigate
  Enter              Select / Create new
  Ctrl-R             Rename
  Ctrl-G             Graduate (promote try to project)
  Ctrl-D             Mark for deletion
  Ctrl-T             Create new try
  Esc                Cancel
"#
    )
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn help_first_line_and_key_sections() {
        let h = global_help("0.0.0");
        assert!(h.starts_with("try v0.0.0 - ephemeral workspace manager\n"));
        assert!(h.contains("\nUsage:\n  try [query]           Interactive directory selector\n"));
        assert!(h.contains("TRY_PROJECTS      Graduate destination (default: parent of TRY_PATH)"));
        assert!(h.ends_with("Esc                Cancel\n"));
    }
}