git-std 0.11.12

Standard git workflow — commits, versioning, hooks
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

use clap_complete::Shell;

/// Shell snippet that enables `git std …` tab-completion.
///
/// `clap_complete::generate` registers completions for the standalone
/// `git-std` binary.  Each shell's git-completion framework uses a
/// different mechanism for custom sub-commands; we append the right
/// wrapper so that `git std <TAB>` works too.
pub fn git_subcommand_wrapper(shell: Shell) -> &'static str {
    match shell {
        Shell::Bash => GIT_SUBCMD_BASH,
        Shell::Zsh => GIT_SUBCMD_ZSH,
        Shell::Fish => GIT_SUBCMD_FISH,
        _ => "",
    }
}

/// Bash: git's completion framework calls `_git_<subcmd>` for custom
/// sub-commands.  We translate `COMP_WORDS` from `("git" "std" …)` to
/// `("git-std" …)` and delegate to the clap-generated `_git-std`.
const GIT_SUBCMD_BASH: &str = r#"
# --- git subcommand wrapper -------------------------------------------
# Enable completion for "git std" (git subcommand invocation).
# Git's bash completion calls _git_<subcmd> for custom subcommands.
_git_std() {
    local _save_words=("${COMP_WORDS[@]}")
    local _save_cword=$COMP_CWORD
    # Merge "git std" into "git-std" so _git-std sees the expected layout.
    COMP_WORDS=("git-std" "${COMP_WORDS[@]:2}")
    (( COMP_CWORD -= 1 ))
    local _cur="${COMP_WORDS[$COMP_CWORD]}"
    local _prev="${COMP_WORDS[$((COMP_CWORD > 0 ? COMP_CWORD - 1 : 0))]}"
    _git-std "git-std" "$_cur" "$_prev"
    COMP_WORDS=("${_save_words[@]}")
    COMP_CWORD=$_save_cword
}
"#;

/// Zsh: register `std` as a git user-command so `_git` delegates to the
/// already-defined `_git-std` completion function.
const GIT_SUBCMD_ZSH: &str = r#"
# --- git subcommand wrapper -------------------------------------------
# Register "std" as a git user-command so "git std <TAB>" triggers _git-std.
zstyle ':completion:*:*:git:*' user-commands std:'Conventional commit standards'
"#;

/// Fish: register `std` as a git subcommand and list top-level
/// sub-commands.  Deeper option completion is handled by the standalone
/// `git-std` completions above.
const GIT_SUBCMD_FISH: &str = r#"
# --- git subcommand wrapper -------------------------------------------
# Register "std" as a git subcommand for "git std <TAB>" completion.
complete -f -c git -n __fish_git_needs_command -a std -d 'Conventional commit standards'
complete -f -c git -n '__fish_git_using_command std' -a commit -d 'Interactive conventional commit builder'
complete -f -c git -n '__fish_git_using_command std' -a lint -d 'Validate commit messages'
complete -f -c git -n '__fish_git_using_command std' -a bump -d 'Version bump, changelog, commit, and tag'
complete -f -c git -n '__fish_git_using_command std' -a version -d 'Query the current project version'
complete -f -c git -n '__fish_git_using_command std' -a changelog -d 'Generate a changelog'
complete -f -c git -n '__fish_git_using_command std' -a init -d 'Scaffold hooks, bootstrap script, and README section'
complete -f -c git -n '__fish_git_using_command std' -a bootstrap -d 'Post-clone environment setup'
complete -f -c git -n '__fish_git_using_command std' -a hook -d 'Git hooks management'
complete -f -c git -n '__fish_git_using_command std' -a doctor -d 'Run health checks'
"#;