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/version.py`.
//!
//! Exposes the powerline-status version string, with an optional git-revision
//! suffix appended when invoked from a working copy.

// from __future__ import (unicode_literals, division, absolute_import, print_function)  // py:2
// (No Rust analogue — Python compatibility shim for 2/3.)

use std::process::Command; // py:4  import subprocess
                           // py:5  from traceback import print_exc — Python's traceback printer.
                           // Rust does not have a 1:1 analogue; we route the equivalent diagnostic
                           // through eprintln! at the catch site (see get_version below).

/// Port of module constant `__version__` from `powerline/version.py:7`.
#[allow(non_upper_case_globals)]
pub const __version__: &str = "2.8.4"; // py:7

/// Port of `get_version()` from `powerline/version.py:9`.
///
/// Returns `__version__` (optionally with a `b<count>` suffix encoding the
/// number of commits since the tag) by shelling out to `git rev-list --count`.
/// Falls back to `__version__` and prints a traceback if git is unavailable.
pub fn get_version() -> String {
    // py:10  try:
    match Command::new("git") // py:11  subprocess.check_output(['git', ...
        .args([
            "rev-list",
            "--count",
            &format!("{}..HEAD", __version__), // py:11  __version__ + '..HEAD'
        ])
        .stderr(std::process::Stdio::null()) // suppress git's noisy stderr — Python's
        // print_exc emits a Python traceback that
        // looks like a powerliners crash; equivalent
        // user-facing behaviour is "silent fall-through".
        .output()
    {
        Ok(out) if out.status.success() => {
            let count = String::from_utf8_lossy(&out.stdout).trim().to_string(); // py:11  .strip().decode()
            format!("{}b{}", __version__, count) // py:11  __version__ + 'b' + ...
        }
        _ => __version__.to_string(), // py:12-14  except Exception: return __version__
    }
}

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

    /// `__version__` matches upstream string literal at version.py:7.
    #[test]
    fn version_constant_matches_upstream() {
        assert_eq!(__version__, "2.8.4");
    }

    /// `get_version()` returns a non-empty string in any environment.
    /// In a git working tree it yields "<version>b<count>", outside one
    /// (or when git fails) it yields just "<version>".
    #[test]
    fn get_version_returns_nonempty() {
        let v = get_version();
        assert!(v.starts_with(__version__));
        assert!(!v.is_empty());
    }
}