about summary refs log tree commit diff
path: root/clippy_dev/src/setup/git_hook.rs
blob: beb07a073fe5d630ab7ab84e242177985f8d67b4 (plain)
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
use std::fs;
use std::path::Path;

/// Rusts setup uses `git rev-parse --git-common-dir` to get the root directory of the repo.
/// I've decided against this for the sake of simplicity and to make sure that it doesn't install
/// the hook if `clippy_dev` would be used in the rust tree. The hook also references this tool
/// for formatting and should therefor only be used in a normal clone of clippy
const REPO_GIT_DIR: &str = ".git";
const HOOK_SOURCE_FILE: &str = "util/etc/pre-commit.sh";
const HOOK_TARGET_FILE: &str = ".git/hooks/pre-commit";

pub fn install_hook(force_override: bool) {
    if check_precondition(force_override).is_err() {
        return;
    }

    // So a little bit of a funny story. Git on unix requires the pre-commit file
    // to have the `execute` permission to be set. The Rust functions for modifying
    // these flags doesn't seem to work when executed with normal user permissions.
    //
    // However, there is a little hack that is also being used by Rust itself in their
    // setup script. Git saves the `execute` flag when syncing files. This means
    // that we can check in a file with execution permissions and the sync it to create
    // a file with the flag set. We then copy this file here. The copy function will also
    // include the `execute` permission.
    match fs::copy(HOOK_SOURCE_FILE, HOOK_TARGET_FILE) {
        Ok(_) => {
            println!("note: the hook can be removed with `cargo dev remove git-hook`");
            println!("Git hook successfully installed :)");
        },
        Err(err) => println!(
            "error: unable to copy `{}` to `{}` ({})",
            HOOK_SOURCE_FILE, HOOK_TARGET_FILE, err
        ),
    }
}

fn check_precondition(force_override: bool) -> Result<(), ()> {
    // Make sure that we can find the git repository
    let git_path = Path::new(REPO_GIT_DIR);
    if !git_path.exists() || !git_path.is_dir() {
        println!("error: clippy_dev was unable to find the `.git` directory");
        return Err(());
    }

    // Make sure that we don't override an existing hook by accident
    let path = Path::new(HOOK_TARGET_FILE);
    if path.exists() {
        if force_override || super::ask_yes_no_question("Do you want to override the existing pre-commit hook it?") {
            return delete_git_hook_file(path);
        }
        return Err(());
    }

    Ok(())
}

pub fn remove_hook() {
    let path = Path::new(HOOK_TARGET_FILE);
    if path.exists() {
        if delete_git_hook_file(path).is_ok() {
            println!("Git hook successfully removed :)");
        }
    } else {
        println!("No pre-commit hook was found. You're good to go :)");
    }
}

fn delete_git_hook_file(path: &Path) -> Result<(), ()> {
    if fs::remove_file(path).is_err() {
        println!("error: unable to delete existing pre-commit git hook");
        Err(())
    } else {
        Ok(())
    }
}