TOC]
Jira提供了完善的RESTful API,如果不想直接請求API接口可以使用Python的Jira庫來操作Jira
Jira Python文檔
安裝方法
pip install jira
認證
Jira的訪問是有權限的,在訪問Jira項目時首先要進行認證,Jira Python庫提供了3種認證方式:
通過Cookis方式認證(用戶名,密碼)
通過Basic Auth方式認證(用戶名,密碼)
通過OAuth方式認證
認證方式只需要選擇一種即可,以下代碼為使用Cookies方式認證。
form jira import JIRA
jira = JIRA('http://jira.***.com/', auth=('用戶名', '登錄密碼')
返回的jira對象便可以對Jira進行操作。主要的操作包括:
項目
問題
搜索
關注者
評論
附件
項目(Project)
jira.projects(): 查看所有項目列表
jira.project("項目的Key"): 查看單個項目
項目對象的主要屬性及方法如下:
key: 項目的Key
name: 項目名稱
description: 項目描述
lead: 項目負責人
projectCategory: 項目分類
components: 項目組件
versions: 項目中的版本
raw: 項目的原始API數據
示例
print(jira.projects()) # 打印所有你有權限訪問的項目列表
project = jira.project('某個項目的Key')
print(project.key, project.name, project.lead)
問題(Issue)
Issue是Jira的核心,Jira中的任務,用戶Story,Bug實質上都是一個Issue。
單個問題對象可以通過jira.issue("問題的Key")得到,問題的主要屬性和方法如下:
id: 問題的id
key: 問題的Key
permalink(): 獲取問題連接
fields: 問題的描述,創建時間等所有的配置域
raw: 問題的原始API數據
聯繫作者:xiaowanzi02620
閱讀更多 七葉離殤花滿樓 的文章