feat: add Object::peel_to_commit() to assure an object turns into a…

… commit.

gix/src/object/peel.rs

@@ -3,7 +3,7 @@
 use crate::{
     object,
     object::{peel, Kind},
-    Object, Tree,
+    Commit, Object, Tree,
 };
 
 ///
@@ -69,10 +69,19 @@ impl<'repo> Object<'repo> {
     }
 
     /// Peel this object into a tree and return it, if this is possible.
+    ///
+    /// This will follow tag objects and commits until their tree is reached.
     pub fn peel_to_tree(self) -> Result<Tree<'repo>, peel::to_kind::Error> {
         Ok(self.peel_to_kind(gix_object::Kind::Tree)?.into_tree())
     }
 
+    /// Peel this object into a commit and return it, if this is possible.
+    ///
+    /// This will follow tag objects until a commit is reached.
+    pub fn peel_to_commit(self) -> Result<Commit<'repo>, peel::to_kind::Error> {
+        Ok(self.peel_to_kind(gix_object::Kind::Commit)?.into_commit())
+    }
+
     // TODO: tests
     /// Follow all tag object targets until a commit, tree or blob is reached.
     ///