tij 0.4.16

Text-mode interface for Jujutsu - a TUI for jj version control
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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

//! jj template definitions for stable output parsing
//!
//! These templates ensure consistent, parseable output from jj commands
//! regardless of user configuration.

/// Separator used between fields in template output (tab character)
pub const FIELD_SEPARATOR: char = '\t';

/// Templates for jj commands
pub struct Templates;

impl Templates {
    /// Template for `jj log` output
    ///
    /// Fields (separated by tab):
    /// 1. change_id (short)
    /// 2. commit_id (short)
    /// 3. author email
    /// 4. timestamp (ISO 8601)
    /// 5. description (first line)
    /// 6. is_working_copy ("true" or "false")
    /// 7. is_empty ("true" or "false")
    /// 8. bookmarks (comma-separated)
    /// 9. has_conflict ("true" or "false") - requires jj 0.12.0+
    ///
    /// Notes:
    /// - jj doesn't interpret `\x1f` escape sequences in templates,
    ///   so we use tab characters with explicit concatenation instead of `separate()`.
    /// - `current_working_copy` is available in jj 0.20.0+.
    ///   (Earlier versions used `self.working_copy()` which no longer exists)
    /// - `conflict` keyword is available in jj 0.12.0+.
    pub fn log() -> &'static str {
        concat!(
            "change_id.short(8)",
            " ++ \"\\t\" ++ ",
            "commit_id.short(8)",
            " ++ \"\\t\" ++ ",
            "author.email()",
            " ++ \"\\t\" ++ ",
            "author.timestamp().format('%Y-%m-%dT%H:%M:%S%z')",
            " ++ \"\\t\" ++ ",
            "description.first_line()",
            " ++ \"\\t\" ++ ",
            "if(current_working_copy, 'true', 'false')",
            " ++ \"\\t\" ++ ",
            "if(empty, 'true', 'false')",
            " ++ \"\\t\" ++ ",
            "bookmarks.map(|b| b.name()).join(',')",
            " ++ \"\\t\" ++ ",
            "if(conflict, 'true', 'false')",
            " ++ \"\\n\""
        )
    }

    /// Template for `jj op log` output
    ///
    /// Fields (separated by tab):
    /// 1. operation_id (short, 12 chars)
    /// 2. user
    /// 3. timestamp
    /// 4. description
    pub fn op_log() -> &'static str {
        concat!(
            "self.id().short(12)",
            " ++ \"\\t\" ++ ",
            "self.user()",
            " ++ \"\\t\" ++ ",
            "self.time().start().ago()",
            " ++ \"\\t\" ++ ",
            "self.description().first_line()",
            " ++ \"\\n\""
        )
    }

    /// Template for getting change metadata (for compare info)
    ///
    /// Fields (separated by tab):
    /// 1. change_id (short, 8 chars)
    /// 2. bookmarks (comma-separated)
    /// 3. author email
    /// 4. timestamp
    /// 5. description (first line)
    pub fn change_info() -> &'static str {
        concat!(
            "change_id.short(8)",
            " ++ \"\\t\" ++ ",
            "bookmarks.map(|b| b.name()).join(',')",
            " ++ \"\\t\" ++ ",
            "author.email()",
            " ++ \"\\t\" ++ ",
            "author.timestamp().format('%Y-%m-%dT%H:%M:%S%z')",
            " ++ \"\\t\" ++ ",
            "description.first_line()",
            " ++ \"\\n\""
        )
    }

    /// Template for `jj file annotate` output
    ///
    /// Uses `commit.change_id().short(8)` and `commit.commit_id().short(8)` to ensure
    /// ID lengths match the log template (8 chars), enabling reliable cross-view ID matching.
    ///
    /// Output format:
    /// `<change_id>\t<commit_id> <author> <timestamp>  <line_number>: <content>`
    ///
    /// Note: Uses AnnotationLine template methods available in jj 0.38+.
    /// The tab separator between change_id and commit_id distinguishes them
    /// from the space-separated remaining fields.
    pub fn file_annotate() -> &'static str {
        concat!(
            "commit.change_id().short(8)",
            " ++ \"\\t\" ++ ",
            "commit.commit_id().short(8)",
            " ++ \" \" ++ ",
            "commit.author().name()",
            " ++ \" \" ++ ",
            "commit.committer().timestamp().format(\"%Y-%m-%d %H:%M:%S\")",
            " ++ \"    \" ++ ",
            "self.line_number()",
            " ++ \": \" ++ ",
            "self.content()",
        )
    }
}

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

    #[test]
    fn test_log_template_is_valid() {
        let template = Templates::log();
        assert!(template.contains("change_id"));
        assert!(template.contains("commit_id"));
        assert!(template.contains("\\t")); // tab separator
        assert!(template.contains("\\n")); // newline at end
    }

    #[test]
    fn test_field_separator_is_tab() {
        assert_eq!(FIELD_SEPARATOR, '\t');
    }

    #[test]
    fn test_file_annotate_template_uses_short_8() {
        let template = Templates::file_annotate();
        assert!(template.contains("change_id().short(8)"));
    }

    #[test]
    fn test_file_annotate_template_has_required_fields() {
        let template = Templates::file_annotate();
        assert!(template.contains("change_id"));
        assert!(template.contains("commit_id"));
        assert!(template.contains("author"));
        assert!(template.contains("line_number"));
        assert!(template.contains("content"));
    }
}