eazygit 0.5.1

A fast TUI for Git with staging, conflicts, rebase, and palette-first UX
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
160
161
162

//! Effect types for side effects in TEA pattern.
//!
//! Effects represent operations that cannot be done purely:
//! - Git operations (stage, commit, push, etc.)
//! - File I/O
//! - Async operations
//!
//! Effects are returned from the update function and executed by the runtime.

use std::path::PathBuf;

/// Side effects that need to be executed outside the pure update function.
/// 
/// Each variant represents an async or I/O operation that the runtime
/// will execute and dispatch a result message when complete.
#[derive(Debug, Clone)]
pub enum Effect {
    // =========================================================================
    // Git Operations
    // =========================================================================
    
    /// Stage a file at the given path.
    GitStage { path: PathBuf },
    
    /// Unstage a file at the given path.
    GitUnstage { path: PathBuf },
    
    /// Stage all changes.
    GitStageAll,
    
    /// Unstage all changes.
    GitUnstageAll,
    
    /// Commit with the given message and options.
    GitCommit {
        message: String,
        amend: bool,
        author_name: Option<String>,
        author_email: Option<String>,
    },
    
    /// Push to remote.
    GitPush { force_with_lease: bool },
    
    /// Pull from remote.
    GitPull { rebase: bool },
    
    /// Fetch from remote.
    GitFetch,
    
    /// Checkout a branch.
    GitCheckout { branch: String },
    
    /// Create a new branch.
    GitCreateBranch { name: String, start_point: Option<String> },
    
    /// Delete a branch.
    GitDeleteBranch { name: String, force: bool },
    
    /// Start interactive rebase.
    GitRebaseStart { 
        base: String,
        use_root: bool,
        todo_content: String,
    },
    
    /// Continue rebase with optional message.
    GitRebaseContinue {
        message: Option<String>,
        author_name: Option<String>,
        author_email: Option<String>,
    },
    
    /// Abort the current rebase.
    GitRebaseAbort,
    
    /// Skip the current rebase step.
    GitRebaseSkip,
    
    /// Cherry-pick a commit.
    GitCherryPick { hash: String },
    
    /// Revert a commit.
    GitRevert { hash: String },
    
    /// Reset to a commit.
    GitReset { target: String, mode: ResetMode },
    
    /// Stash changes.
    GitStash { message: Option<String> },
    
    /// Pop a stash.
    GitStashPop { index: usize },
    
    /// Drop a stash.
    GitStashDrop { stash_ref: String },
    
    // =========================================================================
    // Refresh Operations
    // =========================================================================
    
    /// Refresh the status (working tree, staging area).
    RefreshStatus,
    
    /// Refresh the commit log.
    RefreshLog,
    
    /// Refresh the branch list.
    RefreshBranches,
    
    /// Refresh the stash list.
    RefreshStashes,
    
    /// Refresh everything.
    RefreshAll,
    
    /// Compute diff for a file.
    ComputeDiff { path: PathBuf, staged: bool },
    
    // =========================================================================
    // System Operations
    // =========================================================================
    
    /// Open a file in the external editor.
    OpenInEditor { path: PathBuf },
    
    /// Save configuration (e.g., persist theme choice).
    SaveConfig { key: String, value: String },
    
    /// Execute a custom command.
    ExecuteCustomCommand { name: String, command: String },
    
    // =========================================================================
    // Batch Operations
    // =========================================================================
    
    /// Execute multiple effects in sequence.
    Batch(Vec<Effect>),
    
    /// No-op effect (useful for conditional logic).
    None,
}

/// Reset mode for git reset operations.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ResetMode {
    Soft,
    Mixed,
    Hard,
}

impl Effect {
    /// Create a batch of effects.
    pub fn batch(effects: Vec<Effect>) -> Self {
        Effect::Batch(effects)
    }
    
    /// Check if this is a no-op effect.
    pub fn is_none(&self) -> bool {
        matches!(self, Effect::None)
    }
}