powerliners 0.2.12

1:1 Rust port of powerline/powerline. The ultimate statusline/prompt utility
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

// vim:fileencoding=utf-8:noet
//! Port of `powerline/renderers/shell/zsh.py`.
//!
//! Powerline zsh prompt segment renderer.

// from __future__ import (unicode_literals, division, absolute_import, print_function)  // py:2
// from powerline.renderers.shell import ShellRenderer                                     // py:4

use std::collections::HashMap;

/// Port of `class ZshPromptRenderer(ShellRenderer)` from
/// `powerline/renderers/shell/zsh.py:7`.
///
/// zsh's `%{ ... %}` escape markers (PROMPT_SUBST-safe non-display
/// regions) + the `%` → `%%` translation so literal `%` survives
/// zsh's prompt expansion.
pub struct ZshPromptRenderer;

impl ZshPromptRenderer {
    /// Port of `ZshPromptRenderer.escape_hl_start` from
    /// `powerline/renderers/shell/zsh.py:9`.
    #[allow(non_upper_case_globals)]
    pub const escape_hl_start: &'static str = "%{";

    /// Port of `ZshPromptRenderer.escape_hl_end` from
    /// `powerline/renderers/shell/zsh.py:10`.
    #[allow(non_upper_case_globals)]
    pub const escape_hl_end: &'static str = "%}";

    /// Port of `ZshPromptRenderer.character_translations` from
    /// `powerline/renderers/shell/zsh.py:12-13`.
    ///
    /// Python: extends `ShellRenderer.character_translations` with
    /// `'%' → '%%'`. Until the base table is ported the Rust map is
    /// the diff-only view.
    pub fn character_translations() -> HashMap<char, &'static str> {
        // py:12  ShellRenderer.character_translations.copy()
        let mut t: HashMap<char, &'static str> = HashMap::new();
        // py:13  character_translations[ord('%')] = '%%'
        t.insert('%', "%%");
        t
    }
}

/// Port of module-level binding `renderer` from
/// `powerline/renderers/shell/zsh.py:16`.
#[allow(non_camel_case_types)]
pub type renderer = ZshPromptRenderer;

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

    #[test]
    fn zsh_escape_markers_use_prompt_subst_safe_form() {
        assert_eq!(ZshPromptRenderer::escape_hl_start, "%{");
        assert_eq!(ZshPromptRenderer::escape_hl_end, "%}");
    }

    #[test]
    fn percent_is_doubled_in_translations() {
        let t = ZshPromptRenderer::character_translations();
        assert_eq!(t.get(&'%'), Some(&"%%"));
    }
}