From 233e3ffe0ef35dbabe49340ba567499690dcc166 Mon Sep 17 00:00:00 2001
From: Michael Trier <mtrier@gmail.com>
Date: Fri, 30 May 2008 21:01:44 -0400
Subject: renamed git_python to git. Removed pop_key and replaced with
 dict.pop. Fixed up tests so they pass except for stderr test. Modified
 version information retrieval.

---
 lib/git/tag.py | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 lib/git/tag.py

(limited to 'lib/git/tag.py')

diff --git a/lib/git/tag.py b/lib/git/tag.py
new file mode 100644
index 00000000..fb119f76
--- /dev/null
+++ b/lib/git/tag.py
@@ -0,0 +1,85 @@
+from commit import Commit
+
+class Tag(object):
+    def __init__(self, name, commit):
+        """
+        Instantiate a new Tag
+
+        ``name``
+            is the name of the head
+
+        ``commit``
+            is the Commit that the head points to
+
+        Returns
+            ``GitPython.Tag``
+        """
+        self.name = name
+        self.commit = commit
+
+    @classmethod
+    def find_all(cls, repo, **kwargs):
+        """
+        Find all Tags
+
+        ``repo``
+            is the Repo
+
+        ``kwargs``
+            is a dict of options
+
+        Returns
+            ``GitPython.Tag[]``
+        """
+        options = {'sort': "committerdate",
+                  'format': "%(refname)%00%(objectname)"}
+        options.update(**kwargs)
+
+        output = repo.git.for_each_ref("refs/tags", **options)
+        return cls.list_from_string(repo, output)
+
+    @classmethod
+    def list_from_string(cls, repo, text):
+        """
+        Parse out tag information into an array of baked Tag objects
+
+        ``repo``
+            is the Repo
+
+        ``text``
+            is the text output from the git command
+
+        Returns
+            ``GitPython.Tag[]``
+        """
+        tags = []
+        for line in text.splitlines():
+            tags.append(cls.from_string(repo, line))
+        return tags
+
+    @classmethod
+    def from_string(cls, repo, line):
+        """
+        Create a new Tag instance from the given string.
+
+        ``repo``
+            is the Repo
+
+        ``line``
+            is the formatted tag information
+
+        Format
+            name: [a-zA-Z_/]+
+            <null byte>
+            id: [0-9A-Fa-f]{40}
+
+        Returns
+            ``GitPython.Tag``
+        """
+        full_name, ids = line.split("\x00")
+        name = full_name.split("/")[-1]
+        commit = Commit(repo, **{'id': ids})
+        return Tag(name, commit)
+
+    def __repr__(self):
+        return '<GitPython.Tag "%s">' % self.name
-- 
cgit v1.2.3