FilesExpand file tree

 master

/

GHTeam.java

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

182 lines (157 loc) · 5.08 KB

 master

/

GHTeam.java

Copy path

Top

File metadata and controls

• Code
• Blame

182 lines (157 loc) · 5.08 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

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

package org.kohsuke.github;

import java.io.IOException;

import java.util.Collections;

import java.util.Map;

import java.util.Set;

import java.util.TreeMap;

/**

* A team in GitHub organization.

*

* @author Kohsuke Kawaguchi

*/

public class GHTeam {

private String name,permission,slug;

private int id;

private GHOrganization organization; // populated by GET /user/teams where Teams+Orgs are returned together

protected /*final*/ GHOrganization org;

/** Member's role in a team */

public enum Role {

/**

* A normal member of the team

*/

MEMBER,

/**

* Able to add/remove other team members, promote other team members to team maintainer, and edit the team's name and description.

*/

MAINTAINER

}

/*package*/ GHTeam wrapUp(GHOrganization owner) {

this.org = owner;

return this;

}

/*package*/ GHTeam wrapUp(GitHub root) { // auto-wrapUp when organization is known from GET /user/teams

this.organization.wrapUp(root);

return wrapUp(organization);

}

/*package*/ static GHTeam[] wrapUp(GHTeam[] teams, GHOrganization owner) {

for (GHTeam t : teams) {

t.wrapUp(owner);

}

return teams;

}

public String getName() {

return name;

}

public String getPermission() {

return permission;

}

public String getSlug() {

return slug;

}

public int getId() {

return id;

}

/**

* Retrieves the current members.

*/

public PagedIterable<GHUser> listMembers() throws IOException {

return new PagedIterable<GHUser>() {

public PagedIterator<GHUser> _iterator(int pageSize) {

return new PagedIterator<GHUser>(org.root.retrieve().asIterator(api("/members"), GHUser[].class, pageSize)) {

@Override

protected void wrapUp(GHUser[] page) {

GHUser.wrap(page, org.root);

}

};

}

};

}

public Set<GHUser> getMembers() throws IOException {

return Collections.unmodifiableSet(listMembers().asSet());

}

/**

* Checks if this team has the specified user as a member.

*/

public boolean hasMember(GHUser user) {

try {

org.root.retrieve().to("/teams/" + id + "/members/" + user.getLogin());

return true;

} catch (IOException ignore) {

return false;

}

}

public Map<String,GHRepository> getRepositories() throws IOException {

Map<String,GHRepository> m = new TreeMap<String, GHRepository>();

for (GHRepository r : listRepositories()) {

m.put(r.getName(), r);

}

return m;

}

public PagedIterable<GHRepository> listRepositories() {

return new PagedIterable<GHRepository>() {

public PagedIterator<GHRepository> _iterator(int pageSize) {

return new PagedIterator<GHRepository>(org.root.retrieve().asIterator(api("/repos"), GHRepository[].class, pageSize)) {

@Override

protected void wrapUp(GHRepository[] page) {

for (GHRepository r : page)

r.wrap(org.root);

}

};

}

};

}

/**

* Adds a member to the team.

*

* The user will be invited to the organization if required.

*

* @since 1.59

*/

public void add(GHUser u) throws IOException {

org.root.retrieve().method("PUT").to(api("/memberships/" + u.getLogin()), null);

}

/**

* Adds a member to the team

*

* The user will be invited to the organization if required.

*

* @param user github user

* @param role role for the new member

*

* @throws IOException

*/

public void add(GHUser user, Role role) throws IOException {

org.root.retrieve().method("PUT")

.with("role", role)

.to(api("/memberships/" + user.getLogin()), null);

}

/**

* Removes a member to the team.

*/

public void remove(GHUser u) throws IOException {

org.root.retrieve().method("DELETE").to(api("/members/" + u.getLogin()), null);

}

public void add(GHRepository r) throws IOException {

add(r,null);

}

public void add(GHRepository r, GHOrganization.Permission permission) throws IOException {

org.root.retrieve().method("PUT")

.with("permission", permission)

.to(api("/repos/" + r.getOwnerName() + '/' + r.getName()), null);

}

public void remove(GHRepository r) throws IOException {

org.root.retrieve().method("DELETE").to(api("/repos/" + r.getOwnerName() + '/' + r.getName()), null);

}

/**

* Deletes this team.

*/

public void delete() throws IOException {

org.root.retrieve().method("DELETE").to(api(""));

}

private String api(String tail) {

return "/teams/" + id + tail;

}

public GHOrganization getOrganization() {

return org;

}

}