Как получить поведение `git checkout ...` в Rust git2

ProgramBox

Как получить поведение `git checkout …` в Rust git2

Post author:admin
Запись опубликована:28 мая, 2023
Post category:Вопросы по программированию

#git #rust #checkout #libgit2

#git #Ржавчина #Оформить покупку #libgit2

Вопрос:

Я использую Rust git2 crate для клонирования репозиториев Git, подобных этому

 use git2::Repository;

fn main() {
    let repo = Repository::clone(
        "https://github.com/rossmacarthur/dotfiles",
        "dotfiles"
     ).expect("failed to clone repository");

     repo.checkout("mybranch");  // need something like this.
}

Я хочу иметь возможность извлекать ветку, коммит или тег.

Я просмотрел следующую документацию, но все еще не уверен, какой метод использовать

Я могу сделать следующее, но это изменяет только файлы

 let object = repo
    .revparse_single("mybranch")
    .expect("failed to find identifier");
repo.checkout_tree(amp;object, None)
    .expect(amp;format!("failed to checkout '{:?}'", object));

И если я выполняю сброс, это изменяет заголовок, но не текущую ветку

 repo.reset(amp;object, git2::ResetType::Soft, None)
    .expect(amp;format!("failed to checkout '{:?}'", object));

Ответ №1:

Приведенными ниже примерами являются Rust версии v1.34 и git2 версии 0.8.

Для проверки ветки:

 use git2::*;

fn main() {
    let repo = Repository::clone(
        "https://github.com/rossmacarthur/dotfiles",
        "dotfiles"
    ).expect("failed to clone repository");

    let branch_name = "my_branch";

    let head = repo.head().unwrap();
    let oid = head.target().unwrap();
    let commit = repo.find_commit(oid).unwrap();

    let branch = repo.branch(
        branch_name,
        amp;commit,
        false,
    );

    let obj = repo.revparse_single(amp;("refs/heads/".to_owned()   
        branch_name)).unwrap();

    repo.checkout_tree(
        amp;obj,
        None
    );

    repo.set_head(amp;("refs/heads/".to_owned()   branch_name));
}

Для проверки фиксации:

 use git2::*;

fn main() {
    let repo = Repository::clone(
        "https://github.com/rossmacarthur/dotfiles",
        "dotfiles"
    ).expect("failed to clone repository");

    let my_oid_str = "9411953f92d100f767e6de6325b17afae5231779";

    let oid = Oid::from_str(my_oid_str).unwrap();
    let commit = repo.find_commit(oid).unwrap();

    let branch = repo.branch(
        my_oid_str,
        amp;commit,
        false,
    );

    let obj = repo.revparse_single(amp;("refs/heads/".to_owned()   my_oid_str)).unwrap(); 

    repo.checkout_tree(
        amp;obj,
        None,
    );

    repo.set_head(amp;("refs/heads/".to_owned()   my_oid_str));

}

Для проверки тега попробуйте что-то вроде этого:

 use git2::*;

fn main() {
    // No relation to the example project below.
    // It looks interesting and it has tags!
    let repo = Repository::clone(
        "https://github.com/narke/colorForth.git",
        "colorforth"
    ).expect("failed to clone repository");

    let tag_name = "v2012";

    let references = repo.references().unwrap();

    for reference in references {
        let _reference = reference.unwrap();

        if _reference.is_tag() == true {
            let tag = _reference.peel_to_tag().unwrap();
            if tag.name().unwrap() == tag_name {
                let target_oid = tag.target().unwrap().id();
                let commit = repo.find_commit(target_oid).unwrap();

                let branch = repo.branch(
                    tag_name,
                    amp;commit,
                    false,
                );

                let obj = repo.revparse_single(amp;("refs/heads/".to_owned()   tag_name)).unwrap();

                repo.checkout_tree(
                    amp;obj,
                    None,
                );

                repo.set_head(amp;("refs/heads/".to_owned()   tag_name)); 
            }
        }

    }
}

Бьюсь об заклад, что обычно есть способ получше, но вопрос оставался без ответа в течение нескольких месяцев, и вот как я понял это несколько минут назад.

1. Мой обновленный пост полностью решает вопрос OP. Положительные отзывы приветствуются. У меня даже недостаточно баллов, чтобы прокомментировать чужой пост, например, в OP, поэтому я могу позволить им теперь, когда я успешно ответил на вопрос. Я буду работать над тем, чтобы сделать ответ более идиоматичным, если будет проявлен какой-либо интерес к этому вопросу.

2. В примере для проверки фиксации правильный метод для использования — set_head_detached() — set_head() ожидает ссылочное имя типа refs/heads/master или HEAD (но хэш фиксации не является ссылкой). Итак, правильный способ таков repo.set_head_detached(oid); .

Ответ №2:

С более поздней версией git2 ( v0.13.18 ):

 use git2::Repository;

fn main() {
    let repo = Repository::clone("https://github.com/rossmacarthur/dotfiles", "/tmp/dots")
        .expect("Failed to clone repo");

    let refname = "master"; // or a tag (v0.1.1) or a commit (8e8128)
    let (object, reference) = repo.revparse_ext(refname).expect("Object not found");
    
    repo.checkout_tree(amp;object, None)
        .expect("Failed to checkout");

    match reference {
        // gref is an actual reference like branches or tags
        Some(gref) => repo.set_head(gref.name().unwrap()),
        // this is a commit, not a reference
        None => repo.set_head_detached(object.id()),
    }
    .expect("Failed to set HEAD");
}

Обратите внимание, что checkout_tree устанавливается только содержимое рабочего дерева и set_head только устанавливает HEAD . Запуск только одного из них оставит каталог в грязном состоянии.

Ответ №3:

Я думаю, repo.set_head("mybranch") это то, что вы ищете. Более подробная информация доступна здесь.