Merge branch 'fix-jira-remove_user_from_group' of https://github.com/YugoHino/atlassian-python-api into fix-jira-remove_user_from_group

Author: YugoHino

atlassian/VERSION

@@ -1 +1 @@
-3.25.0
+3.26.0

atlassian/bitbucket/__init__.py

@@ -995,6 +995,41 @@ def project_groups_with_administrator_permissions(self, key):
         """
         return [group["group"]["name"] for group in self.project_groups(key) if group["permission"] == "PROJECT_ADMIN"]
 
+    def repo_users_with_administrator_permissions(self, project_key, repo_key):
+        """
+        Get repository administrators for repository
+        :param project_key: The project key
+        :param repo_key: The repository key
+        :return: List of repo administrators
+        """
+        repo_administrators = []
+        for user in self.repo_users(project_key, repo_key):
+            if user["permission"] == "REPO_ADMIN":
+                repo_administrators.append(user)
+        for group in self.repo_groups_with_administrator_permissions(project_key, repo_key):
+            for user in self.group_members(group):
+                repo_administrators.append(user)
+        for user in self.project_users_with_administrator_permissions(project_key):
+            repo_administrators.append(user)
+        # We convert to a set to ensure uniqueness then back to a list for later useability
+        return list({user["id"]: user for user in repo_administrators}.values())
+
+    def repo_groups_with_administrator_permissions(self, project_key, repo_key):
+        """
+        Get groups with admin permissions
+        :param project_key:
+        :param repo_key:
+        :return:
+        """
+        repo_group_administrators = []
+        for group in self.repo_groups(project_key, repo_key):
+            if group["permission"] == "REPO_ADMIN":
+                repo_group_administrators.append(group["group"]["name"])
+        for group in self.project_groups_with_administrator_permissions(project_key):
+            repo_group_administrators.append(group)
+        # We convert to a set to ensure uniqueness, then back to a list for later useability
+        return list(set(repo_group_administrators))
+
     def repo_grant_group_permissions(self, project_key, repo_key, groupname, permission):
         """
         Grant the specified repository permission to an specific group

atlassian/jira.py

@@ -795,6 +795,36 @@ def remove_user_from_group(self, username=None, group_name=None, account_id=None
             params = {"groupname": group_name, "username": username}
         return self.delete(url, params=params)
 
+    def get_users_with_browse_permission_to_a_project(
+        self, username, issue_key=None, project_key=None, start=0, limit=100
+    ):
+        """
+        Returns a list of active users that match the search string. This resource cannot be accessed anonymously
+        and requires the Browse Users global permission. Given an issue key this resource will provide a list of users
+        that match the search string and have the browse issue permission for the issue provided.
+
+        :param: username:
+        :param: issueKey:
+        :param: projectKey:
+        :param: startAt: OPTIONAL
+        :param: maxResults: OPTIONAL
+        :return: List of active users who has browser permission for the given project_key or issue_key
+        """
+        url = self.resource_url("user/viewissue/search")
+        params = {}
+        if username:
+            params["username"] = username
+        if issue_key:
+            params["issueKey"] = issue_key
+        if project_key:
+            params["projectKey"] = project_key
+        if start:
+            params["startAt"] = start
+        if limit:
+            params["maxResults"] = limit
+
+        return self.get(url, params=params)
+
     """
     Issue
     Reference: https://docs.atlassian.com/software/jira/docs/api/REST/8.5.0/#api/2/issue

docs/jira.rst

@@ -147,6 +147,10 @@ Manage projects
     # Use 'expand' to get details (default is None)  possible values are notificationSchemeEvents,user,group,projectRole,field,all
     jira.get_priority_scheme_of_project(project_key_or_id, expand=None)
 
+    # Returns a list of active users who have browse permission for a project that matches the search string for username.
+    # Using " " string (space) for username gives All the active users who have browse permission for a project
+    jira.get_users_with_browse_permission_to_a_project(self, username, issue_key=None, project_key=None, start=0, limit=100)
+
 Manage issues
 -------------
 

examples/jira/jira_dc_remove_stale_nodes.py

@@ -0,0 +1,10 @@
+# coding=utf-8
+from atlassian import Jira
+
+"""Remove stale nodes from cluster before version 8.10
+See https://confluence.atlassian.com/jirakb/remove-abandoned-or-offline-nodes-in-jira-data-center-946616137.html
+"""
+jira = Jira(url="http://localhost:8080", username="admin", password="admin")
+stale_node_ids = [_["nodeId"] for _ in jira.get_cluster_all_nodes() if not _["alive"] and _["state"] == "OFFLINE"]
+for _ in stale_node_ids:
+    jira.delete_cluster_node(_)

examples/jira/jira_download_attachments.py

@@ -0,0 +1,42 @@
+from atlassian import Jira
+import os
+
+""" Download the attachments from tickets """
+
+JIRA_URL = "localhost:8080"
+JIRA_LOGIN = "admin"
+JIRA_TOKEN = "dsadd2c3s"
+
+
+def get_tickets(jql):
+    pass
+
+
+if __name__ == "__main__":
+    jira = Jira(url=JIRA_URL, username=JIRA_LOGIN, token=JIRA_TOKEN)
+    jql = "project = DOC"
+    tickets = jira.jql(jql=jql, fields=["key,attachment"], limit=1000).get("issues")
+
+    for ticket in tickets:
+        mail_folder = "tickets"
+        if not os.path.exists(mail_folder):
+            os.makedirs(mail_folder)
+        key = ticket.get("key")
+        attachments = ticket.get("fields").get("attachment")
+
+        for attachment in attachments:
+            dest_folder = mail_folder + "/" + key
+            if not os.path.exists(dest_folder):
+                os.makedirs(dest_folder)
+            filename = attachment.get("filename")
+            author = attachment.get("author").get("emailAddress")
+            attachment_id = attachment.get("id")
+            content_url = attachment.get("content")
+            session = jira._session
+            response = session.get(url=content_url)
+
+            if response.status_code != 200:
+                continue
+            with open(dest_folder + "/" + filename, "wb") as f:
+                print(f"Saving for {key} the file {filename}")
+                f.write(response.content)