1 files changed, 79 insertions, 0 deletions
diff --git a/src/git/reference.rs b/src/git/reference.rs
new file mode 100644
index 0000000..fb213cb
--- /dev/null
+++ b/src/git/reference.rs
@@ -0,0 +1,79 @@
+use crate::git::reference_kind::ReferenceKind;
+
+/// Represents a pointer to an object in Git.
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub(crate) struct Reference {
+	/// The object id
+	pub(crate) hash: String,
+	/// The reference full name
+	pub(crate) name: String,
+	/// The reference shorthand name
+	pub(crate) shorthand: String,
+	/// The kind of reference
+	pub(crate) kind: ReferenceKind,
+}
+
+impl Reference {
+	/// Get the oid of the reference
+	#[must_use]
+	#[inline]
+	pub(crate) fn hash(&self) -> &str {
+		self.hash.as_str()
+	}
+
+	/// Get the name of the reference
+	#[must_use]
+	#[inline]
+	pub(crate) fn name(&self) -> &str {
+		self.name.as_str()
+	}
+
+	/// Get the shorthand name of the reference
+	#[must_use]
+	#[inline]
+	pub(crate) fn shortname(&self) -> &str {
+		self.shorthand.as_str()
+	}
+
+	/// Get the kind of the reference
+	#[must_use]
+	#[inline]
+	pub(crate) const fn kind(&self) -> ReferenceKind {
+		self.kind
+	}
+
+	pub(crate) fn from(reference: &git2::Reference<'_>) -> Self {
+		let oid = reference
+			.peel(git2::ObjectType::Any)
+			.expect("Reference peel failed")
+			.id();
+		let kind = ReferenceKind::from(reference);
+		let name = String::from(reference.name().unwrap_or("InvalidRef"));
+		let shorthand = String::from(reference.shorthand().unwrap_or("InvalidRef"));
+
+		Self {
+			hash: format!("{oid}"),
+			name,
+			shorthand,
+			kind,
+		}
+	}
+}
+
+#[cfg(test)]
+mod tests {
+	use super::*;
+	use crate::git::testutil::{head_id, with_temp_repository};
+
+	#[test]
+	fn test() {
+		with_temp_repository(|repository| {
+			let oid = head_id(&repository, "main");
+			let reference = repository.find_reference("refs/heads/main").unwrap();
+			assert_eq!(reference.hash(), format!("{oid}"));
+			assert_eq!(reference.name(), "refs/heads/main");
+			assert_eq!(reference.shortname(), "main");
+			assert_eq!(reference.kind(), ReferenceKind::Branch);
+		});
+	}
+}