[object #177] tag::RefIter -> TagRefIter

Author: Byron

git-object/src/blob.rs

@@ -1,8 +1,6 @@
-use crate::Blob;
-use crate::BlobRef;
+use std::{convert::Infallible, io};
 
-use std::convert::Infallible;
-use std::io;
+use crate::{Blob, BlobRef};
 
 impl Blob {
     /// Write the blobs data to `out` verbatim.

git-object/src/immutable/mod.rs

@@ -10,7 +10,4 @@ pub mod commit;
 ///
 pub mod object;
 
-///
-pub mod tag;
-
 pub(crate) mod parse;

git-object/src/immutable/tag.rs

@@ -9,11 +9,10 @@ use std::borrow::Cow;
 pub use bstr;
 use bstr::{BStr, BString, ByteSlice};
 use smallvec::SmallVec;
-
+use tree::Entry;
 pub use types::{Error, Kind};
 
 use crate::tree::EntryRef;
-use tree::Entry;
 
 pub mod immutable;
 pub mod mutable;
@@ -117,6 +116,13 @@ pub struct TagRef<'a> {
     pub pgp_signature: Option<&'a BStr>,
 }
 
+/// Like [`TagRef`], but as `Iterator` to support entirely allocation free parsing.
+/// It's particularly useful to dereference only the target chain.
+pub struct TagRefIter<'a> {
+    data: &'a [u8],
+    state: tag::ref_iter::State,
+}
+
 /// A mutable git tag.
 #[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone)]
 #[cfg_attr(feature = "serde1", derive(serde::Serialize, serde::Deserialize))]

git-object/src/lib.rs

@@ -60,8 +60,7 @@ impl Object {
 mod convert {
     use std::convert::TryFrom;
 
-    use crate::Object;
-    use crate::{Blob, Commit, Tag, Tree};
+    use crate::{Blob, Commit, Object, Tag, Tree};
 
     impl From<Tag> for Object {
         fn from(v: Tag) -> Self {

git-object/src/mutable/object.rs

@@ -3,8 +3,10 @@ use std::io;
 use bstr::BStr;
 use quick_error::quick_error;
 
-use crate::mutable::{encode, NL};
-use crate::Tag;
+use crate::{
+    mutable::{encode, NL},
+    Tag,
+};
 
 quick_error! {
     /// An Error used in [`Tag::write_to()`].