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
|
# -*- encoding: utf-8 -*-
from . import Service
class Teams(Service):
""" Consume `Teams API <http://developer.github.com/v3/orgs/teams/>`_
.. warning ::
You must be authenticated as an owner of the org
"""
def list(self, org):
""" Get org's teams
:param str org: Organisation name
:returns: A :doc:`result`
"""
request = self.request_builder('orgs.teams.list', org=org)
return self._get_result(request)
def get(self, id):
""" Get a team
:param int id: The team id
:returns: A :doc:`result`
"""
request = self.request_builder('orgs.teams.get', id=id)
return self._get(request)
def create(self, org, data):
""" Create a new team
:param str org: Organisation name
:param dict data: Input. See `github orgs teams doc`_
"""
request = self.request_builder('orgs.teams.create', org=org, body=data)
return self._post(request)
def update(self, id, data):
""" Update a team
:param int id: The team id
:param dict data: Input. See `github orgs teams doc`_
"""
request = self.request_builder('orgs.teams.update', id=id, body=data)
return self._patch(request)
def delete(self, id):
""" Delete a team
:param int id: The team id
"""
request = self.request_builder('orgs.teams.delete', id=id)
return self._delete(request)
def list_members(self, id):
""" List the members of a team
:param int id: The team id
:returns: A :doc:`result`
"""
request = self.request_builder('orgs.teams.list_members', id=id)
return self._get_result(request)
def is_member(self, id, user):
""" Determine if user is a member of a team
:param int id: The team id
:param str user: User name
"""
request = self.request_builder('orgs.teams.is_member',
id=id, user=user)
return self._bool(request)
def add_member(self, id, user):
""" Add a user to a team
:param int id: The team id
:param str user: User name
"""
request = self.request_builder('orgs.teams.add_member',
id=id, user=user)
return self._put(request)
def remove_member(self, id, user):
""" Remove a member from a team
:param int id: The team id
:param str user: User name
"""
request = self.request_builder('orgs.teams.remove_member',
id=id, user=user)
return self._delete(request)
def list_repos(self, id):
""" List the repos that a team's members get access to
:param int id: The team id
:returns: A :doc:`result`
"""
request = self.request_builder('orgs.teams.list_repos', id=id)
return self._get_result(request)
def contains_repo(self, id, user, repo):
""" Determine if user is a member of a team
:param int id: The team id
:param str user: User name
:param str repo: Repo name
"""
request = self.request_builder('orgs.teams.contains_repo',
id=id, user=user, repo=repo)
return self._bool(request)
def add_repo(self, id, user, repo):
""" Give team members access to a repo
:param int id: The team id
:param str user: User name
:param str repo: Repo name
"""
request = self.request_builder('orgs.teams.add_repo',
id=id, user=user, repo=repo)
return self._put(request)
def remove_repo(self, id, user, repo):
""" Remove a repo from the a team
:param int id: The team id
:param str user: User name
:param str repo: Repo name
"""
request = self.request_builder('orgs.teams.remove_repo',
id=id, user=user, repo=repo)
return self._delete(request)
|
