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
///
pub mod set_target_id {
use gix_error::bail;
use gix_ref::{Target, transaction::PreviousValue};
use crate::{Reference, Result, bstr::BString};
impl Reference<'_> {
/// Set the id of this direct reference to `id` and use `reflog_message` for the reflog (if enabled in the repository).
///
/// Note that the operation will fail on symbolic references, to change their type use the lower level reference database,
/// or if the reference was deleted or changed in the mean time.
/// Furthermore, refrain from using this method for more than a one-off change as it creates a transaction for each invocation.
/// If multiple reference should be changed, use [`Repository::edit_references()`][crate::Repository::edit_references()]
/// or the lower level reference database instead.
pub fn set_target_id(
&mut self,
id: impl Into<gix_hash::ObjectId>,
reflog_message: impl Into<BString>,
) -> Result<()> {
match &self.inner.target {
Target::Symbolic(name) => {
bail!("Cannot change symbolic reference {name:?} into a direct one by setting it to an id");
}
Target::Object(current_id) => {
let changed = self.repo.reference(
self.name(),
id,
PreviousValue::MustExistAndMatch(Target::Object(current_id.to_owned())),
reflog_message,
)?;
*self = changed;
}
}
Ok(())
}
}
}
///
pub mod delete {
use crate::Result;
use gix_ref::transaction::{PreviousValue, RefEdit};
use crate::Reference;
impl Reference<'_> {
/// Delete this reference or fail if it was changed since last observed.
/// Note that this instance remains available in memory but probably shouldn't be used anymore.
pub fn delete(&self) -> Result<()> {
self.repo
.edit_reference(RefEdit::delete(
self.inner.name.clone(),
PreviousValue::MustExistAndMatch(self.inner.target.clone()),
))
.map(|_| ())
}
}
}