OXYGENHUB
# ff1f62fee654 oxygen / crates / oxy-core / src / repo / prompt.rs
19.4 KiB · Rust · last changed Log, blame and fsck at the scale of the Linux tree 1 month ago source blame history raw
1
//! Fast, side-effect-free status for shell prompts.
2
//!
3
//! Every snapshot and checkout writes a manifest of the working copy as it
4
//! was last seen: `size`, `mtime`, and BLAKE3 of each file. `quick_status`
5
//! walks the working copy and compares against that manifest, reading a
6
//! file's content only when its size or mtime changed, and records no
7
//! operation. Ahead/behind counts come from walking the store between the
8
//! local bookmark and its `origin` tracking state.
9
10
use super::*;
11
use std::time::UNIX_EPOCH;
12
13
#[derive(Debug, Clone, Default, PartialEq, Eq)]
14
pub struct PromptInfo {
15
    pub bookmark: String,
16
    /// Working-copy ChangeId prefix.
17
    pub change_id: String,
18
    pub heads: usize,
19
    pub dirty: bool,
20
    pub conflicted: bool,
21
    /// Changes local `main` has that `origin/main` lacks, when tracking exists.
22
    pub ahead: Option<usize>,
23
    pub behind: Option<usize>,
24
}
25
26
impl PromptInfo {
27
    /// The glyph for the working copy's state: `‼` conflicted, `✎` dirty,
28
    /// `✔` clean.
29
    pub fn state_glyph(&self) -> &'static str {
30
        if self.conflicted {
31
            "‼"
32
        } else if self.dirty {
33
            "✎"
34
        } else {
35
            "✔"
36
        }
37
    }
38
39
    /// The ANSI colour (SGR parameter) for the state: red, yellow, or cyan.
40
    pub fn state_color(&self) -> u8 {
41
        if self.conflicted {
42
            31
43
        } else if self.dirty {
44
            33
45
        } else {
46
            36
47
        }
48
    }
49
50
    /// `format` wrapped in the state colour. `guard` is `("\\[", "\\]")` for
51
    /// bash prompts, `("%{", "%}")` for zsh, or empty for raw output.
52
    pub fn format_colored(&self, fmt: &str, guard: (&str, &str)) -> String {
53
        format!(
54
            "{}\x1b[{}m{}{}{}\x1b[0m{}",
55
            guard.0,
56
            self.state_color(),
57
            guard.1,
58
            self.format(fmt),
59
            guard.0,
60
            guard.1
61
        )
62
    }
63
64
    /// Expand `%b` bookmark, `%c` change id, `%h` heads, `%d` dirty marker
65
    /// (`*`), `%x` conflict marker (`!`), `%a`/`%B` ahead/behind counts
66
    /// (empty when unknown), `%A`/`%D` `+n`/`-n` when non-zero, `%s` the
67
    /// state glyph, `%U`/`%O` `↑n`/`↓n` when non-zero, `%i` the repository
68
    /// icon, `%%` percent.
69
    pub fn format(&self, fmt: &str) -> String {
70
        let mut out = String::new();
71
        let mut chars = fmt.chars();
72
        while let Some(c) = chars.next() {
73
            if c != '%' {
74
                out.push(c);
75
                continue;
76
            }
77
            match chars.next() {
78
                Some('b') => out.push_str(&self.bookmark),
79
                Some('c') => out.push_str(&self.change_id),
80
                Some('h') => out.push_str(&self.heads.to_string()),
81
                Some('d') => {
82
                    if self.dirty {
83
                        out.push('*');
84
                    }
85
                }
86
                Some('x') => {
87
                    if self.conflicted {
88
                        out.push('!');
89
                    }
90
                }
91
                Some('a') => out.push_str(&self.ahead.map(|n| n.to_string()).unwrap_or_default()),
92
                Some('B') => out.push_str(&self.behind.map(|n| n.to_string()).unwrap_or_default()),
93
                Some('A') => {
94
                    if let Some(n) = self.ahead.filter(|n| *n > 0) {
95
                        out.push_str(&format!("+{n}"));
96
                    }
97
                }
98
                Some('D') => {
99
                    if let Some(n) = self.behind.filter(|n| *n > 0) {
100
                        out.push_str(&format!("-{n}"));
101
                    }
102
                }
103
                Some('s') => out.push_str(self.state_glyph()),
104
                Some('U') => {
105
                    if let Some(n) = self.ahead.filter(|n| *n > 0) {
106
                        out.push_str(&format!("↑{n}"));
107
                    }
108
                }
109
                Some('O') => {
110
                    if let Some(n) = self.behind.filter(|n| *n > 0) {
111
                        out.push_str(&format!("↓{n}"));
112
                    }
113
                }
114
                Some('i') => out.push_str(ICON),
115
                Some('%') => out.push('%'),
116
                Some(other) => {
117
                    out.push('%');
118
                    out.push(other);
119
                }
120
                None => out.push('%'),
121
            }
122
        }
123
        out
124
    }
125
}
126
127
/// Path → (size, mtime in nanoseconds, BLAKE3 hex) as last seen.
128
/// One manifest entry: the file's stat, its content hash, and the stored
129
/// blob for an opaque file.
130
#[derive(Clone, Debug)]
131
pub(crate) struct ManifestEntry {
132
    pub size: u64,
133
    pub mtime_ns: u128,
134
    pub hash: String,
135
    pub blob: Option<ObjectRef>,
136
    /// The graph key (`State::graph_key`) of the base file this text file
137
    /// was found equal to, rendered, byte for byte.
138
    pub graph: Option<String>,
139
    /// Whether the file was executable: a mode change alters neither size
140
    /// nor time.
141
    pub exec: bool,
142
}
143
144
#[derive(Clone, Debug, Default)]
145
pub(crate) struct Manifest {
146
    /// When the manifest was written, for the racy-stat guard.
147
    pub written_ns: u128,
148
    pub entries: BTreeMap<String, ManifestEntry>,
149
}
150
151
pub(crate) fn mtime_ns(m: &fs::Metadata) -> u128 {
152
    m.modified()
153
        .ok()
154
        .and_then(|t| t.duration_since(UNIX_EPOCH).ok())
155
        .map(|d| d.as_nanos())
156
        .unwrap_or(0)
157
}
158
159
pub const DEFAULT_PROMPT_FORMAT: &str = "%b %c%d%x%A%D";
160
/// The repository icon for `%i` (an atom, for oxygen).
161
pub const ICON: &str = "⚛";
162
/// A format with glyphs: icon, bookmark, change id, state, ahead/behind.
163
pub const GLYPH_PROMPT_FORMAT: &str = "%i %b %c %s%U%O";
164
165
/// One manifest line per file: size, mtime in nanoseconds, hash, blob ref
166
/// or `-`, graph key or `-`, `x` when executable or `-`, path.
167
fn manifest_line(
168
    path: &str,
169
    size: u64,
170
    mtime_ns: u128,
171
    hash: &str,
172
    blob: Option<ObjectRef>,
173
    graph: Option<&str>,
174
    exec: bool,
175
) -> String {
176
    format!(
177
        "{size}\t{mtime_ns}\t{hash}\t{}\t{}\t{}\t{path}\n",
178
        blob.map(|b| b.to_hex()).unwrap_or_else(|| "-".into()),
179
        graph.unwrap_or("-"),
180
        if exec { "x" } else { "-" }
181
    )
182
}
183
184
impl Repo {
185
    pub(crate) fn manifest_path(&self) -> PathBuf {
186
        self.oxy
187
            .join("workspaces")
188
            .join(self.workspace.to_hex())
189
            .join("manifest")
190
    }
191
192
    /// Record the working copy as it is now (after a snapshot, commit, or
193
    /// checkout), with header lines saying whether the base state is
194
    /// conflicted and whether the working-copy change holds uncommitted work.
195
    pub(crate) fn write_manifest(&self, conflicted: bool, uncommitted: bool) -> Result<()> {
196
        let entries = self.walk_working_copy()?;
197
        self.write_manifest_entries(conflicted, uncommitted, &entries, &HashMap::new())
198
    }
199
200
    /// Write the manifest from entries already walked; `blobs` names the
201
    /// stored blob of each opaque path so the next walk can skip reading it.
202
    pub(crate) fn write_manifest_entries(
203
        &self,
204
        conflicted: bool,
205
        uncommitted: bool,
206
        entries: &BTreeMap<String, FsEntry>,
207
        blobs: &HashMap<String, ObjectRef>,
208
    ) -> Result<()> {
209
        let written = std::time::SystemTime::now()
210
            .duration_since(UNIX_EPOCH)
211
            .map(|d| d.as_nanos())
212
            .unwrap_or(0);
213
        let head = format!(
214
            "# conflicted={}\n# uncommitted={}\n",
215
            conflicted as u8, uncommitted as u8
216
        );
217
        let mut body = String::new();
218
        let mut newest_ns: u128 = 0;
219
        for (path, e) in entries {
220
            let full = self.root.join(path);
221
            let (size, mtime_ns) = match fs::symlink_metadata(&full) {
222
                Ok(m) => (m.len(), mtime_ns(&m)),
223
                Err(_) => (e.content.len() as u64, 0),
224
            };
225
            let hash = match &e.content_hash {
226
                Some(h) => h.clone(),
227
                None => blake3::hash(&e.content).to_hex().to_string(),
228
            };
229
            let blob = blobs.get(path).copied().or(e.blob);
230
            newest_ns = newest_ns.max(mtime_ns);
231
            body.push_str(&manifest_line(
232
                path,
233
                size,
234
                mtime_ns,
235
                &hash,
236
                blob,
237
                e.graph_key.as_deref(),
238
                e.exec,
239
            ));
240
        }
241
        let p = self.manifest_path();
242
        // Leave an unchanged manifest alone when its stamp already trusts
243
        // every entry (none is within the racy window): rewriting it would
244
        // change nothing but the file, which editors watching the tree
245
        // (and subrepos inside it) take as a change.
246
        if let Ok(old) = fs::read_to_string(&p) {
247
            let old_written: Option<u128> = old.lines().find_map(|l| {
248
                l.strip_prefix("# written=")
249
                    .and_then(|v| v.trim().parse().ok())
250
            });
251
            let old_rest: String = old
252
                .lines()
253
                .filter(|l| !l.starts_with("# written="))
254
                .map(|l| format!("{l}\n"))
255
                .collect();
256
            if let Some(w) = old_written {
257
                if old_rest == format!("{head}{body}") && newest_ns + 2_000_000_000 < w {
258
                    return Ok(());
259
                }
260
            }
261
        }
262
        let text = format!("{head}# written={written}\n{body}");
263
        fs::create_dir_all(p.parent().unwrap())?;
264
        write_atomic(&p, text.as_bytes())
265
    }
266
267
    /// Change the header flags, and set the graph key of each path in
268
    /// `keys` (after a commit, the new base's keys of the files it holds as
269
    /// they are on disk).
270
    pub(crate) fn rewrite_manifest(
271
        &self,
272
        conflicted: bool,
273
        uncommitted: bool,
274
        keys: &HashMap<String, String>,
275
    ) -> Result<()> {
276
        let p = self.manifest_path();
277
        let text = match fs::read_to_string(&p) {
278
            Ok(t) => t,
279
            Err(_) => return self.write_manifest(conflicted, uncommitted),
280
        };
281
        let mut out = String::with_capacity(text.len());
282
        for line in text.lines() {
283
            if line.starts_with("# conflicted=") {
284
                out.push_str(&format!("# conflicted={}\n", conflicted as u8));
285
            } else if line.starts_with("# uncommitted=") {
286
                out.push_str(&format!("# uncommitted={}\n", uncommitted as u8));
287
            } else {
288
                let f: Vec<&str> = line.splitn(7, '\t').collect();
289
                match (f.len() == 7).then(|| keys.get(f[6])).flatten() {
290
                    Some(k) => out.push_str(&format!(
291
                        "{}\t{}\t{}\t{}\t{k}\t{}\t{}\n",
292
                        f[0], f[1], f[2], f[3], f[5], f[6]
293
                    )),
294
                    None => {
295
                        out.push_str(line);
296
                        out.push('\n');
297
                    }
298
                }
299
            }
300
        }
301
        write_atomic(&p, out.as_bytes())
302
    }
303
304
    /// Forget the manifest after an operation that changed the working-copy
305
    /// change without a snapshot (undo, rewrites); the prompt shows blank
306
    /// markers until the next snapshot.
307
    pub(crate) fn drop_manifest(&self) {
308
        let _ = fs::remove_file(self.manifest_path());
309
    }
310
311
    pub(crate) fn read_manifest(&self) -> Result<Option<(bool, bool, Manifest)>> {
312
        let text = match fs::read_to_string(self.manifest_path()) {
313
            Ok(t) => t,
314
            Err(e) if e.kind() == std::io::ErrorKind::NotFound => return Ok(None),
315
            Err(e) => return Err(e.into()),
316
        };
317
        let mut out = Manifest::default();
318
        let mut conflicted = false;
319
        let mut uncommitted = false;
320
        for line in text.lines() {
321
            if let Some(v) = line.strip_prefix("# conflicted=") {
322
                conflicted = v.trim() == "1";
323
                continue;
324
            }
325
            if let Some(v) = line.strip_prefix("# uncommitted=") {
326
                uncommitted = v.trim() == "1";
327
                continue;
328
            }
329
            if let Some(v) = line.strip_prefix("# written=") {
330
                out.written_ns = v.trim().parse().unwrap_or(u128::MAX);
331
                continue;
332
            }
333
            // A line of another shape (an older manifest) is no entry: the
334
            // file is then read, and the next snapshot rewrites the line.
335
            let f: Vec<&str> = line.splitn(7, '\t').collect();
336
            if f.len() == 7 {
337
                out.entries.insert(
338
                    f[6].to_string(),
339
                    ManifestEntry {
340
                        size: f[0].parse().unwrap_or(0),
341
                        mtime_ns: f[1].parse().unwrap_or(0),
342
                        hash: f[2].to_string(),
343
                        blob: ObjectRef::from_hex(f[3]),
344
                        graph: (f[4] != "-").then(|| f[4].to_string()),
345
                        exec: f[5] == "x",
346
                    },
347
                );
348
            }
349
        }
350
        Ok(Some((conflicted, uncommitted, out)))
351
    }
352
353
    /// Whether the working copy is certainly clean, known from the manifest
354
    /// alone, without loading any history (spec §12.4): the last snapshot
355
    /// or commit found no uncommitted work and no conflict, every entry is
356
    /// older than the racy window (so an equal size and time mean equal
357
    /// content), there are no subrepos (whose state the manifest does not
358
    /// hold), and no file was added, removed or changed since. `false`
359
    /// means only that a snapshot must decide.
360
    pub fn clean_by_manifest(&self) -> Result<bool> {
361
        let _t = crate::timing::phase("status: check the manifest");
362
        let Some((conflicted, uncommitted, m)) = self.read_manifest()? else {
363
            return Ok(false);
364
        };
365
        if conflicted || uncommitted || self.root.join(".oxymodules").exists() {
366
            return Ok(false);
367
        }
368
        let racy = m
369
            .entries
370
            .values()
371
            .any(|e| e.mtime_ns + 2_000_000_000 >= m.written_ns);
372
        if racy {
373
            return Ok(false);
374
        }
375
        Ok(self.quick_dirty()? == Some(false))
376
    }
377
378
    /// Whether the working copy differs from the last manifest. Without a
379
    /// manifest the answer is `None`.
380
    pub fn quick_dirty(&self) -> Result<Option<bool>> {
381
        let Some((_, uncommitted, manifest)) = self.read_manifest()? else {
382
            return Ok(None);
383
        };
384
        if uncommitted {
385
            return Ok(Some(true));
386
        }
387
        let mut seen = 0usize;
388
        let nested = std::sync::Arc::new(std::sync::Mutex::new(Vec::new()));
389
        let wb = self.walker(&nested);
390
        for entry in wb.build() {
391
            let Ok(entry) = entry else { continue };
392
            let Some(ft) = entry.file_type() else {
393
                continue;
394
            };
395
            if ft.is_dir() {
396
                continue;
397
            }
398
            let rel: String = entry
399
                .path()
400
                .strip_prefix(&self.root)
401
                .unwrap()
402
                .components()
403
                .map(|c| c.as_os_str().to_string_lossy().to_string())
404
                .collect::<Vec<_>>()
405
                .join("/");
406
            if !self.in_scope(&rel) {
407
                continue;
408
            }
409
            let Some(me) = manifest.entries.get(&rel) else {
410
                return Ok(Some(true));
411
            };
412
            seen += 1;
413
            let m = fs::symlink_metadata(entry.path())?;
414
            let now_mtime = mtime_ns(&m);
415
            if ft.is_symlink() {
416
                let target = fs::read_link(entry.path())?;
417
                if blake3::hash(target.to_string_lossy().as_bytes())
418
                    .to_hex()
419
                    .as_str()
420
                    != me.hash
421
                {
422
                    return Ok(Some(true));
423
                }
424
                continue;
425
            }
426
            if m.len() != me.size || super::is_executable(&m) != me.exec {
427
                return Ok(Some(true));
428
            }
429
            if now_mtime != me.mtime_ns
430
                && blake3::hash(&fs::read(entry.path())?).to_hex().as_str() != me.hash
431
            {
432
                return Ok(Some(true));
433
            }
434
        }
435
        if seen == manifest.entries.len() {
436
            return Ok(Some(false));
437
        }
438
        // Manifest entries the walk skipped: tracked files that ignore rules
439
        // hide. They count as present when still on disk and unchanged.
440
        for (rel, me) in &manifest.entries {
441
            let path = self.root.join(rel);
442
            let Ok(m) = fs::symlink_metadata(&path) else {
443
                return Ok(Some(true));
444
            };
445
            if m.file_type().is_symlink() {
446
                continue;
447
            }
448
            if m.len() != me.size
449
                || super::is_executable(&m) != me.exec
450
                || (mtime_ns(&m) != me.mtime_ns
451
                    && blake3::hash(&fs::read(&path)?).to_hex().as_str() != me.hash)
452
            {
453
                return Ok(Some(true));
454
            }
455
        }
456
        Ok(Some(false))
457
    }
458
459
    /// Prompt information without recording anything.
460
    pub fn quick_status(&self) -> Result<PromptInfo> {
461
        let view = self.view()?;
462
        let bookmark = self.config.bookmark.clone();
463
        let heads = self.heads_of(&view, &bookmark)?;
464
        let wc_hash = view.workspaces.get(&self.workspace).copied();
465
        let change_id = match wc_hash {
466
            Some(h) => self.store.get_change_meta(&h)?.change_id.short(8),
467
            None => String::new(),
468
        };
469
        // Conflictedness was recorded by the last snapshot; without a
470
        // manifest (never snapshotted) both flags are unknown and shown clear.
471
        let manifest = self.read_manifest()?;
472
        let conflicted = manifest.as_ref().map(|(c, _, _)| *c).unwrap_or(false);
473
        let dirty = self.quick_dirty()?.unwrap_or(false);
474
        let (ahead, behind) = match view.remotes.get("origin").and_then(|b| b.get(&bookmark)) {
475
            Some(st) => {
476
                let remote_heads = self.store.get_state(st)?.heads;
477
                let ahead = self.negotiate(&remote_heads, &heads).map(|v| v.len()).ok();
478
                let behind = self.negotiate(&heads, &remote_heads).map(|v| v.len()).ok();
479
                (ahead, behind)
480
            }
481
            None => (None, None),
482
        };
483
        Ok(PromptInfo {
484
            bookmark,
485
            change_id,
486
            heads: heads.len(),
487
            dirty,
488
            conflicted,
489
            ahead,
490
            behind,
491
        })
492
    }
493
}
494
495
#[cfg(test)]
496
mod tests {
497
    use super::*;
498
499
    #[test]
500
    fn placeholders_and_glyphs() {
501
        let clean = PromptInfo {
502
            bookmark: "main".into(),
503
            change_id: "658990aa".into(),
504
            heads: 1,
505
            dirty: false,
506
            conflicted: false,
507
            ahead: Some(0),
508
            behind: None,
509
        };
510
        assert_eq!(clean.format(DEFAULT_PROMPT_FORMAT), "main 658990aa");
511
        assert_eq!(clean.format(GLYPH_PROMPT_FORMAT), "⚛ main 658990aa ✔");
512
        let busy = PromptInfo {
513
            dirty: true,
514
            ahead: Some(2),
515
            behind: Some(3),
516
            ..clean.clone()
517
        };
518
        assert_eq!(busy.format(DEFAULT_PROMPT_FORMAT), "main 658990aa*+2-3");
519
        assert_eq!(busy.format(GLYPH_PROMPT_FORMAT), "⚛ main 658990aa ✎↑2↓3");
520
        let bad = PromptInfo {
521
            conflicted: true,
522
            ..busy.clone()
523
        };
524
        assert_eq!(bad.format("%s%x%d %h %a/%B %%"), "‼!* 1 2/3 %");
525
        assert_eq!(bad.state_color(), 31);
526
        assert_eq!(
527
            busy.format_colored("%b", ("\\[", "\\]")),
528
            "\\[\x1b[33m\\]main\\[\x1b[0m\\]"
529
        );
530
        assert_eq!(clean.format_colored("%b", ("", "")), "\x1b[36mmain\x1b[0m");
531
        assert_eq!(clean.format("%q"), "%q");
532
    }
533
}