FilesExpand file tree

 master

/

git_refs.go

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

162 lines (137 loc) · 4.1 KB

 master

/

git_refs.go

Copy path

Top

File metadata and controls

• Code
• Blame

162 lines (137 loc) · 4.1 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

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

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

// Copyright 2013 The go-github AUTHORS. All rights reserved.

//

// Use of this source code is governed by a BSD-style

// license that can be found in the LICENSE file.

package github

import (

"fmt"

"strings"

)

// Reference represents a GitHub reference.

type Reference struct {

Ref *string `json:"ref"`

URL *string `json:"url"`

Object *GitObject `json:"object"`

}

func (r Reference) String() string {

return Stringify(r)

}

// GitObject represents a Git object.

type GitObject struct {

Type *string `json:"type"`

SHA *string `json:"sha"`

URL *string `json:"url"`

}

func (o GitObject) String() string {

return Stringify(o)

}

// createRefRequest represents the payload for creating a reference.

type createRefRequest struct {

Ref *string `json:"ref"`

SHA *string `json:"sha"`

}

// updateRefRequest represents the payload for updating a reference.

type updateRefRequest struct {

SHA *string `json:"sha"`

Force *bool `json:"force"`

}

// GetRef fetches the Reference object for a given Git ref.

//

// GitHub API docs: http://developer.github.com/v3/git/refs/#get-a-reference

func (s *GitService) GetRef(owner string, repo string, ref string) (*Reference, *Response, error) {

ref = strings.TrimPrefix(ref, "refs/")

u := fmt.Sprintf("repos/%v/%v/git/refs/%v", owner, repo, ref)

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

r := new(Reference)

resp, err := s.client.Do(req, r)

if err != nil {

return nil, resp, err

}

return r, resp, err

}

// ReferenceListOptions specifies optional parameters to the

// GitService.ListRefs method.

type ReferenceListOptions struct {

Type string `url:"-"`

ListOptions

}

// ListRefs lists all refs in a repository.

//

// GitHub API docs: http://developer.github.com/v3/git/refs/#get-all-references

func (s *GitService) ListRefs(owner, repo string, opt *ReferenceListOptions) ([]Reference, *Response, error) {

var u string

if opt != nil && opt.Type != "" {

u = fmt.Sprintf("repos/%v/%v/git/refs/%v", owner, repo, opt.Type)

} else {

u = fmt.Sprintf("repos/%v/%v/git/refs", owner, repo)

}

u, err := addOptions(u, opt)

if err != nil {

return nil, nil, err

}

req, err := s.client.NewRequest("GET", u, nil)

if err != nil {

return nil, nil, err

}

var rs []Reference

resp, err := s.client.Do(req, &rs)

if err != nil {

return nil, resp, err

}

return rs, resp, err

}

// CreateRef creates a new ref in a repository.

//

// GitHub API docs: http://developer.github.com/v3/git/refs/#create-a-reference

func (s *GitService) CreateRef(owner string, repo string, ref *Reference) (*Reference, *Response, error) {

u := fmt.Sprintf("repos/%v/%v/git/refs", owner, repo)

req, err := s.client.NewRequest("POST", u, &createRefRequest{

// back-compat with previous behavior that didn't require 'refs/' prefix

Ref: String("refs/" + strings.TrimPrefix(*ref.Ref, "refs/")),

SHA: ref.Object.SHA,

})

if err != nil {

return nil, nil, err

}

r := new(Reference)

resp, err := s.client.Do(req, r)

if err != nil {

return nil, resp, err

}

return r, resp, err

}

// UpdateRef updates an existing ref in a repository.

//

// GitHub API docs: http://developer.github.com/v3/git/refs/#update-a-reference

func (s *GitService) UpdateRef(owner string, repo string, ref *Reference, force bool) (*Reference, *Response, error) {

refPath := strings.TrimPrefix(*ref.Ref, "refs/")

u := fmt.Sprintf("repos/%v/%v/git/refs/%v", owner, repo, refPath)

req, err := s.client.NewRequest("PATCH", u, &updateRefRequest{

SHA: ref.Object.SHA,

Force: &force,

})

if err != nil {

return nil, nil, err

}

r := new(Reference)

resp, err := s.client.Do(req, r)

if err != nil {

return nil, resp, err

}

return r, resp, err

}

// DeleteRef deletes a ref from a repository.

//

// GitHub API docs: http://developer.github.com/v3/git/refs/#delete-a-reference

func (s *GitService) DeleteRef(owner string, repo string, ref string) (*Response, error) {

ref = strings.TrimPrefix(ref, "refs/")

u := fmt.Sprintf("repos/%v/%v/git/refs/%v", owner, repo, ref)

req, err := s.client.NewRequest("DELETE", u, nil)

if err != nil {

return nil, err

}

return s.client.Do(req, nil)

}