lds-git 0.13.1

Git module for local-develop-server (lds) — git2-rs backed read/write with session-scoped write safety
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

//! Reset operations — destructive, so they're guarded by the same ownership
//! check as `commit` / `merge`.
//!
//! `git reset --hard` is the most reflog-heavy thing this crate does. We
//! capture HEAD before and after so callers can produce an audit line ("HEAD
//! moved from X to Y, mode=hard"), and so an undo path is at least
//! discoverable via the reflog rather than silently lost.

use std::path::Path;

use anyhow::Result;

use crate::output::{ResetMode, ResetOutput};
use crate::{GitModule, TIMEOUT_LOCAL, git_cmd};

impl GitModule {
    /// Move HEAD to `target`, with `mode` controlling the working tree
    /// behaviour. The working directory MUST be owned by the current
    /// session — see [`GitModule::ensure_session_scope`].
    ///
    /// * [`ResetMode::Soft`]   — move HEAD only (`git reset --soft`)
    /// * [`ResetMode::Mixed`]  — also reset index but keep worktree (`--mixed`)
    /// * [`ResetMode::Hard`]   — also overwrite worktree (`--hard`)
    pub async fn reset(
        &self,
        working_dir: &Path,
        mode: ResetMode,
        target: &str,
    ) -> Result<ResetOutput> {
        self.ensure_session_scope(working_dir)?;

        let previous_head = git_cmd(working_dir, &["rev-parse", "HEAD"], TIMEOUT_LOCAL).await?;
        let flag = match mode {
            ResetMode::Soft => "--soft",
            ResetMode::Mixed => "--mixed",
            ResetMode::Hard => "--hard",
        };
        git_cmd(working_dir, &["reset", flag, target], TIMEOUT_LOCAL).await?;
        let current_head = git_cmd(working_dir, &["rev-parse", "HEAD"], TIMEOUT_LOCAL).await?;

        Ok(ResetOutput {
            mode,
            target: target.to_string(),
            previous_head,
            current_head,
        })
    }
}