JIRA 模块 bug管理工具

from jira import JIRA #导入jira
jira=JIRA(server='http://127.0.0.1:8080', basic_auth=('name', 'password')) #和jira服务器建立连接

#获取当前用户
jira.user(jira.current_user())

#获取当前用户所有项目，返回项目字典
for j in jira.projects():
　　print j, j.name #打印项目名称；

#通过字段id号获取issu
issue = jira.issue('JRA-1330', fields='summary,description，comment')
summary = issue.fields.summary
description = issue.fields.description

#查询issues
jql = "project=PROJ AND component = 模块 AND status=closed AND summary ~标题 AND description ~描述"
try:
    issues = self.jira.search_issues(jql, maxResults=500) #maxResults参数是设置返回数据的最大值，默认是50。
except Exception as e:
    print(e)
    sys.exit(-1)
bug_count=len(issues) #查询的bug数
for issue in issue_search(): 
　　issue = str(issue) + issue.fields.summary #标题
   projectKey = issue.key.split("-")[0]  # 获得bug的项目key
　　print issue return issue

components = jira.project_components(jira.project("项目key"))  # 获得某项目的所有模块名称
# 创建项目模块
jira.create_component(compoment, project, description=description, leadUserName=None, assigneeType=None, isAssigneeTypeValid=False) 

#查询相关参数
projects   #所有项目，projects = jira.projects()
project    #项目
components  #模块
summary    #标题
issuetype  #获取缺陷类型，如缺陷，线上问题、改进等
deion      #获取缺陷的具体描述内容
assignee   #经办人，currentUser()现在的用户
reporter   #报告人
resolution #解决结果,重复Duplicate,开始unresolved,
status     #bug状态,关闭closed,已解决resolved
due        #到期时间,due < endOfWeek()
created    #创建时间
updated    #更新时间
priority   #优先级，按优先级排序orderby priority desc
#评论 
comments_a = issue.fields.comments.comments
comments_b = jira.comments(issue) # comments_b ==comments_a

#更新bug信息 
issue = jira.issue('JIRA-2')
issue.update(versions=[{"name":'V1.1'}])
issue.update(labels=['Label A','Label B'])
issue.update(components=[{'name': 'component'}])
issue.update(summary='new summary', description='description')
issue.update(assignee={'name': 'new_user'}) 
issue.update(issuetype={'name': 'Task'})
#更改bug状态status
transitions=self.jira.transitions(issue)
print([(t['id'],t['name']) for t in transitions])
self.jira.transition_issue(issue, 'To Do')
#或者
self.jira.transition_issue(issue, 11)

issue_dict= {
'summary': 'issue概要',
'description': 'issue描述',
}
issue.update(fields=issue_dict)

def create_issue(self, summary, description, assignee, compoment, project, issuetype='Task', priority='Medium'):
    """
    创建提交bug
    :param project: 项目
    :param issuetype: 问题类型，Task
    :param summary: 主题
    :param compoment: 模块
    :param description: 描述
    :param assignee: 经办人
    :param priority: 优先级
    :return:
    """
    issue_dict = {
        'project': {'key': project},
        'issuetype': {'name': issuetype},
        'summary': summary,
        'components': [{'name': compoment}],
        'description': description,
        'assignee': {'name': assignee},
        'priority': {'name': priority},
    }
    return self.jira.create_issue(issue_dict)

#封装jira一些方法
from jira import JIRA
import sys

class JiraTool():
    def __init__(self, server, username, password, maxResults = 500):
        self.server = server
        self.basic_auth = (username, password)
        # issues查询的最大值
        self.maxResults = maxResults

    def login(self):
        self.jira = JIRA(server=self.server, basic_auth=self.basic_auth)
        if self.jira == None:
            print('连接失败')
            sys.exit(-1)

    def get_projects(self):
        """
        获得jira 的所有项目
        :return:
        """
        return [(p.key, p.name, p.id) for p in self.jira.projects()]

    def get_components(self, project):
        """
        获得某项目的所有模块
        :param project:
        :return:
        """
        return [(c.name, c.id) for c in self.jira.project_components(self.jira.project(project))]

    def create_component(self, project, compoment, description, leadUserName=None, assigneeType=None, isAssigneeTypeValid=False):
        """
        # 创建项目模块
        :param project: 模块所属项目
        :param compoment:模块名称
        :param description:模块描述
        :param leadUserName:
        :param assigneeType:
        :param isAssigneeTypeValid:
        :return:
        """
        components = self.jira.project_components(self.jira.project(project))
        if compoment not in [c.name for c in components]:
            self.jira.create_component(compoment, project, description=description, leadUserName=leadUserName,
                                       assigneeType=assigneeType, isAssigneeTypeValid=isAssigneeTypeValid)

    def create_issue(self, project, compoment, summary, description, assignee, issuetype, priority='Medium'):
        """
        创建提交bug
        :param project: 项目
        :param issuetype: 问题类型，Task
        :param summary: 主题
        :param compoment: 模块
        :param description: 描述
        :param assignee: 经办人
        :param priority: 优先级
        :return:
        """
        issue_dict = {
            'project': {'key': project},
            'issuetype': {'id': issuetype},
            'summary': summary,
            'components': [{'name': compoment}],
            'description': description,
            'assignee': {'name': assignee},
            'priority': {'name': priority},
        }
        return self.jira.create_issue(issue_dict)

    def delete_issue(self, issue):
        """
        删除bug
        :param issue:
        :return:
        """
        issue.delete()

    def update_issue_content(self, issue, issue_dict):
        """
        更新bug内容
        :param issue:
        :param issue_dict:
            issue_dict = {
                'project': {'key': project},
                'issuetype': {'id': issuetype},
                'summary': summary,
                'components': [{'name': compoment}],
                'description': description,
                'assignee': {'name': assignee},
                'priority': {'name': priority},
            }
        :return:
        """
        issue.update(fields=issue_dict)
    def update_issue_issuetype(self, issue, issuetype):
        """
        更新bug 状态
        :param issue:
        :param issuetype: 可以为id值如11，可以为值如'恢复开启问题'
        :return:
        """
        transitions = self.jira.transitions(issue)
        # print([(t['id'], t['name']) for t in transitions])
        self.jira.transition_issue(issue, issuetype)

    def search_issues(self, jql):
        """
        查询bug
        :param jql: 查询语句，如"project=项目key AND component = 模块 AND status=closed AND summary ~标题 AND description ~描述"
        :return:
        """
        try:
            # maxResults参数是设置返回数据的最大值，默认是50。
            issues = self.jira.search_issues(jql, maxResults=self.maxResults)
        except Exception as e:
            print(e)
            sys.exit(-1)
        return issues
    def search_issue_content(self, issue, content_type):
        """
        获取bug 的相关信息
        :param issue:
        :param content_type:项目project; 模块名称components; 标题summary; 缺陷类型issuetype; 具体描述内容description; 经办人assignee; 报告人reporter; 解决结果resolution; bug状态status; 优先级priority; 创建时间created; 更新时间updated; 评论comments
        :return:
        """
        # 评论
        if content_type == 'comments':
            return [c.body for c in self.jira.comments(issue)]
        if hasattr(issue.fields, content_type):
            result = getattr(issue.fields, content_type)
            if isinstance(result, list):
                return [c.name for c in result if hasattr(c, 'name')]
            return result

if __name__ == '__main__':
    jiratool = JiraTool('http://127.0.0.0:8080', '用户名', '密码')
    jiratool.login()
    issues = jiratool.search_issues('project=项目名称 AND component = 模块名称')
    for issue in issues:
        print(jiratool.search_issue_content(issue,'comments'))

参考官网官网：https://jira.readthedocs.io/en/master/