返回的jira对象便可以对Jira进行操作。主要的操作包括:
项目对象的主要属性及方法如下:
Issue是Jira的核心,Jira中的任务,用户Story,Bug实质上都是一个Issue。
单个问题对象可以通过jira.issue("问题的Key")得到,问题的主要属性和方法如下:
一般问题的ields中的属性分为固定属性和自定义属性,自定义属性格式一般为类似customfield_10012这种。常用的问题的Fields有:
issue = jira.issue(‘JRA-1330‘)
print(jiaa.watchers(issue)) # 所有关注者
jira.add_watcher(issue, ‘username‘) # 添加关注者
print(jira.comments(issue)) # 所有评论
comment = jira.comment(issue, ‘10234‘) # 某条评论
jira.add_comment(issue, ‘new comment‘) # 新增评论
comment.update(body=‘update comment‘) # 更新评论
comment.delete() # 删除该评论
print(issue.fields.attachment) # 问题附件
jira.add_attachment(issue=issue, attachment=‘/some/path/attachment.txt‘) # 添加附件
示例如下:
# 创建问题
issue_dict = {
‘project‘: {‘id‘: 123},
‘summary‘: ‘New issue from jira-python‘,
‘description‘: ‘Look into this one‘,
‘issuetype‘: {‘name‘: ‘Bug‘},
}
new_issue = jira.create_issue(fields=issue_dict)
# 批量创建问题
issue_list = [
{
‘project‘: {‘id‘: 123},
‘summary‘: ‘First issue of many‘,
‘description‘: ‘Look into this one‘,
‘issuetype‘: {‘name‘: ‘Bug‘},
},
{
‘project‘: {‘key‘: ‘FOO‘},
‘summary‘: ‘Second issue‘,
‘description‘: ‘Another one‘,
‘issuetype‘: {‘name‘: ‘Bug‘},
},
{
‘project‘: {‘name‘: ‘Bar‘},
‘summary‘: ‘Last issue‘,
‘description‘: ‘Final issue of batch.‘,
‘issuetype‘: {‘name‘: ‘Bug‘},
}]
issues = jira.create_issues(field_list=issue_list)
# 分配问题
jira.assign_issue(issue, ‘newassignee‘)
# 转换问题
jira.transition_issue(issue, ‘5‘, assignee={‘name‘: ‘pm_user‘}, resolution={‘id‘: ‘3‘})
Jira的搜索非常强大,并配有一套专门的搜索语言,称为JQL(Jira Query Language),Jira的Python库便是基于JQL语法进行搜索的,返回的是搜索到的问题列表。
使用语句为
jira.search_issues(‘JQL语句‘)
默认最大结果数未1000,可以通过maxResults参数配置,该参数为-1时不限制数量,返回所有搜索结果。
jira.search_issues(‘project=PROJ and assignee = currentUser()‘, maxResults=-1)
原文:https://www.cnblogs.com/qev211/p/12218636.html