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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
# tag.py
# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
#
# This module is part of GitPython and is released under
# the BSD License: http://www.opensource.org/licenses/bsd-license.php
import commit
import base
class TagRef(base.Ref):
"""
Class representing a lightweight tag reference which either points to a commit
or to a tag object. In the latter case additional information, like the signature
or the tag-creator, is available.
This tag object will always point to a commit object, but may carray additional
information in a tag object::
tagref = TagRef.find_all(repo)[0]
print tagref.commit.message
if tagref.tag is not None:
print tagref.tag.message
"""
__slots__ = "tag"
def __init__(self, path, commit_or_tag):
"""
Initialize a newly instantiated Tag
``path``
is the full path to the tag
``commit_or_tag``
is the Commit or TagObject that this tag ref points to
"""
super(TagRef, self).__init__(path, commit_or_tag)
self.tag = None
if commit_or_tag.type == "tag":
self.tag = commit_or_tag
# END tag object handling
@property
def commit(self):
"""
Returns
Commit object the tag ref points to
"""
if self.object.type == "commit":
return self.object
# it is a tag object
return self.object.object
@classmethod
def find_all(cls, repo, common_path = "refs/tags", **kwargs):
"""
Returns
git.Tag[]
For more documentation, please refer to git.base.Ref.find_all
"""
return super(TagRef,cls).find_all(repo, common_path, **kwargs)
# provide an alias
Tag = TagRef
class TagObject(base.Object):
"""
Non-Lightweight tag carrying additional information about an object we are pointing
to.
"""
type = "tag"
__slots__ = ( "object", "tag", "tagger", "tagged_date", "message" )
def __init__(self, repo, id, object=None, tag=None,
tagger=None, tagged_date=None, message=None):
"""
Initialize a tag object with additional data
``repo``
repository this object is located in
``id``
SHA1 or ref suitable for git-rev-parse
``object``
Object instance of object we are pointing to
``tag``
name of this tag
``tagger``
Actor identifying the tagger
``tagged_date`` : (tm_year, tm_mon, tm_mday, tm_hour, tm_min, tm_sec, tm_wday, tm_yday, tm_isdst)
is the DateTime of the tag creation
"""
super(TagObject, self).__init__(repo, id )
self._set_self_from_args_(locals())
def _set_cache_(self, attr):
"""
Cache all our attributes at once
"""
if attr in self.__slots__:
output = self.repo.git.cat_file(self.type,self.id)
lines = output.split("\n")
obj, hexsha = lines[0].split(" ") # object <hexsha>
type_token, type_name = lines[1].split(" ") # type <type_name>
self.object = base.Object.get_type_by_name(type_name)(self.repo, hexsha)
self.tag = lines[2][4:] # tag <tag name>
tagger_info = lines[3][7:]# tagger <actor> <date>
self.tagger, self.tagged_date = commit.Commit._actor(tagger_info)
# line 4 empty - check git source to figure out purpose
self.message = "\n".join(lines[5:])
# END check our attributes
else:
super(TagObject, self)._set_cache_(attr)
|
