def add_to_attention_set(self, input_):
"""
Adds a single user to the attention set of a change.
support this method since v3.3.0
A user can only be added if they are not in the attention set.
If a user is added while already in the attention set, the request is silently ignored.
.. code-block:: python
input_ = {
"user": "******",
"reason": "reason"
}
change = gerrit.changes.get('myProject~stable~I10394472cbd17dd12454f229e4f6de00b143a444')
result = change.add_to_attention_set(input_)
:param input_: the AttentionSetInput entity,
https://gerrit-review.googlesource.com/Documentation/rest-api-changes.html#attention-set-input
:return:
"""
version = self.gerrit.version
if parse(version) < parse("3.3.0"):
raise UnsupportMethod("The server does not support this method")
endpoint = "/changes/%s/attention" % self.id
base_url = self.gerrit.get_endpoint_url(endpoint)
response = self.gerrit.requester.post(
base_url, json=input_, headers=self.gerrit.default_headers)
result = self.gerrit.decode_response(response)
return result
def set_displayname(self, input_):
"""
Sets the display name of an account.
support this method since v3.2.0
.. code-block:: python
input_ = {
"display_name": "Kevin"
}
account = gerrit.accounts.get('kevin.shi')
result = account.set_displayname(input_)
:param input_: the DisplayNameInput entity,
https://gerrit-review.googlesource.com/Documentation/rest-api-accounts.html#display-name-input
:return:
"""
version = self.gerrit.version
if parse(version) < parse("3.2.0"):
raise UnsupportMethod("The server does not support this method")
endpoint = "/accounts/%s/displayname" % self.username
base_url = self.gerrit.get_endpoint_url(endpoint)
response = self.gerrit.requester.put(
base_url, json=input_, headers=self.gerrit.default_headers
)
result = self.gerrit.decode_response(response)
# update account model's displayname
self.displayname = result
return result
def create_change(self, input_):
"""
Create Change for review.
support this method since v3.3.0
.. code-block:: python
input_ = {
"subject": "Let's support 100% Gerrit workflow direct in browser",
"branch": "stable",
"topic": "create-change-in-browser",
"status": "NEW"
}
project = gerrit.projects.get('myproject')
result = project.create_change(input_)
:param input_:
:return:
"""
version = self.gerrit.version
if parse(version) < parse("3.3.0"):
raise UnsupportMethod("The server does not support this method")
endpoint = "/projects/%s/create.change" % self.id
base_url = self.gerrit.get_endpoint_url(endpoint)
response = self.gerrit.requester.post(
base_url, json=input_, headers=self.gerrit.default_headers)
result = self.gerrit.decode_response(response)
return GerritChange.parse(result, gerrit=self.gerrit)
def get_attention_set(self):
"""
Returns all users that are currently in the attention set.
support this method since v3.3.0
:return:
"""
version = self.gerrit.version
if parse(version) < parse("3.3.0"):
raise UnsupportMethod("The server does not support this method")
endpoint = "/changes/%s/attention" % self.id
response = self.gerrit.requester.get(self.gerrit.get_endpoint_url(endpoint))
result = self.gerrit.decode_response(response)
return result
def revert_submission(self):
"""
Creates open revert changes for all of the changes of a certain submission.
If the user doesn’t have revert permission on the change or upload permission on the destination,
the response is '403 Forbidden', and the error message is contained in the response body.
If the change cannot be reverted because the change state doesn’t allow reverting the change
the response is '409 Conflict', and the error message is contained in the response body.
:return:
"""
version = self.gerrit.version
if parse(version) < parse("3.2.0"):
raise UnsupportMethod("The server does not support this method")
endpoint = "/changes/%s/revert_submission" % self.id
response = self.gerrit.requester.post(self.gerrit.get_endpoint_url(endpoint))
result = self.gerrit.decode_response(response)
return result
def remove_from_attention_set(self, id_, input_=None):
"""
Deletes a single user from the attention set of a change.
support this method since v3.3.0
A user can only be removed from the attention set.
if they are currently in the attention set. Otherwise, the request is silently ignored.
.. code-block:: python
input_ = {
"reason": "reason"
}
change = gerrit.changes.get('myProject~stable~I10394472cbd17dd12454f229e4f6de00b143a444')
change.remove_from_attention_set('kevin.shi', input_)
# or
change.remove_from_attention_set('kevin.shi')
:param id_: account id
:param input_: the AttentionSetInput entity,
https://gerrit-review.googlesource.com/Documentation/rest-api-changes.html#attention-set-input
:return:
"""
version = self.gerrit.version
if parse(version) < parse("3.3.0"):
raise UnsupportMethod("The server does not support this method")
if input_ is None:
endpoint = "/changes/%s/attention/%s" % (self.id, id_)
self.gerrit.requester.delete(
self.gerrit.get_endpoint_url(endpoint))
else:
endpoint = "/changes/%s/attention/%s/delete" % (self.id, id_)
base_url = self.gerrit.get_endpoint_url(endpoint)
response = self.gerrit.requester.post(
base_url, json=input_, headers=self.gerrit.default_headers)
result = self.gerrit.decode_response(response)
return result