htoprs 0.4.1

A faithful Rust port of htop — the interactive process viewer
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

//! #3 — capture + diff a process table.
//!
//! htop keeps no record of any moment. This dumps the table to JSON (reusing
//! the `extensions::prefs` serde-json pattern) and diffs two captures by PID
//! for incident forensics: what appeared, what died, what changed.

use std::collections::BTreeMap;

use serde::{Deserialize, Serialize};

use crate::extensions::model::Proc;

/// A frozen process table plus the tick it was taken at.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct Snapshot {
    pub tick: u64,
    pub procs: Vec<Proc>,
}

impl Snapshot {
    pub fn capture(tick: u64, table: &[Proc]) -> Self {
        Snapshot {
            tick,
            procs: table.to_vec(),
        }
    }

    pub fn to_json(&self) -> String {
        serde_json::to_string_pretty(self).expect("Proc serializes")
    }

    pub fn from_json(s: &str) -> Result<Self, serde_json::Error> {
        serde_json::from_str(s)
    }
}

/// A PID present in both snapshots whose observable fields moved.
#[derive(Clone, Debug, PartialEq)]
pub struct Change {
    pub pid: u32,
    pub before: Proc,
    pub after: Proc,
}

/// Result of diffing `a` (before) against `b` (after).
#[derive(Clone, Debug, PartialEq, Default)]
pub struct Diff {
    pub added: Vec<Proc>,
    pub removed: Vec<Proc>,
    pub changed: Vec<Change>,
}

/// Diff two snapshots, keyed by PID. `changed` reports rows whose cpu, mem,
/// state, or cmdline differ (a PID reused for a new command shows up here).
pub fn diff(a: &Snapshot, b: &Snapshot) -> Diff {
    let before: BTreeMap<u32, &Proc> = a.procs.iter().map(|p| (p.pid, p)).collect();
    let after: BTreeMap<u32, &Proc> = b.procs.iter().map(|p| (p.pid, p)).collect();

    let mut d = Diff::default();
    for (pid, bp) in &after {
        match before.get(pid) {
            None => d.added.push((*bp).clone()),
            Some(ap) => {
                if ap.cpu != bp.cpu
                    || ap.mem_kb != bp.mem_kb
                    || ap.state != bp.state
                    || ap.cmdline != bp.cmdline
                {
                    d.changed.push(Change {
                        pid: *pid,
                        before: (*ap).clone(),
                        after: (*bp).clone(),
                    });
                }
            }
        }
    }
    for (pid, ap) in &before {
        if !after.contains_key(pid) {
            d.removed.push((*ap).clone());
        }
    }
    d
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::extensions::model::synthetic_table;

    #[test]
    fn json_roundtrips() {
        let s = Snapshot::capture(2, &synthetic_table(2));
        let back = Snapshot::from_json(&s.to_json()).unwrap();
        assert_eq!(s, back);
    }

    #[test]
    fn detects_added_and_removed() {
        let a = Snapshot::capture(0, &synthetic_table(0)); // has pid 500
        let b = Snapshot::capture(4, &synthetic_table(4)); // no pid 500
        let d = diff(&a, &b);
        assert!(d.removed.iter().any(|p| p.pid == 500));
        assert!(!d.added.iter().any(|p| p.pid == 500));
    }

    #[test]
    fn identical_snapshots_have_empty_diff() {
        let a = Snapshot::capture(1, &synthetic_table(1));
        let d = diff(&a, &a);
        assert!(d.added.is_empty() && d.removed.is_empty() && d.changed.is_empty());
    }
}