forked from piotrmurach/github
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathtags.rb
More file actions
78 lines (70 loc) · 2.4 KB
/
Copy pathtags.rb
File metadata and controls
78 lines (70 loc) · 2.4 KB
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
# encoding: utf-8
module Github
class GitData::Tags < API
# This tags api only deals with tag objects -
# so only annotated tags, not lightweight tags.
VALID_TAG_PARAM_NAMES = %w[
tag
message
object
type
name
email
date
sha
url
tagger
].freeze
VALID_TAG_PARAM_VALUES = {
'type' => %w[ blob tree commit ]
}
# Get a tag
#
# = Examples
# github = Github.new
# github.git_data.tags.get 'user-name', 'repo-name', 'sha'
#
def get(*args)
arguments(args, :required => [:user, :repo, :sha])
params = arguments.params
get_request("/repos/#{user}/#{repo}/git/tags/#{sha}", params)
end
alias :find :get
# Create a tag object
# Note that creating a tag object does not create the reference that
# makes a tag in Git. If you want to create an annotated tag in Git,
# you have to do this call to create the tag object, and then create
# the <tt>refs/tags/[tag]</tt> reference. If you want to create a lightweight tag, you simply have to create the reference - this call would be unnecessary.
#
# = Parameters
# * <tt>:tag</tt> - String of the tag
# * <tt>:message</tt> - String of the tag message
# * <tt>:object</tt> - String of the SHA of the git object this is tagging
# * <tt>:type</tt> - String of the type of the object we're tagging. Normally this is a <tt>commit</tt> but it can also be a <tt>tree</tt> or a <tt>blob</tt>
# * tagger.name:: String of the name of the author of the tag
# * tagger.email:: String of the email of the author of the tag
# * tagger.date:: Timestamp of when this object was tagged
#
# = Examples
# github = Github.new
# github.git_data.tags.create 'user-name', 'repo-name',
# "tag" => "v0.0.1",
# "message" => "initial version\n",
# "type" => "commit",
# "object" => "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c",
# "tagger" => {
# "name" => "Scott Chacon",
# "email" => "[email protected]",
# "date" => "2011-06-17T14:53:3"
# }
#
def create(*args)
arguments(args, :required => [:user, :repo]) do
sift VALID_TAG_PARAM_NAMES
assert_values VALID_TAG_PARAM_VALUES
end
params = arguments.params
post_request("/repos/#{user}/#{repo}/git/tags", params)
end
end # GitData::Tags
end # Github