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/
版权声明：本文为snailgirl原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。