Jira，一个强大灵活的 Python 库

大家好！我是爱摸鱼的小鸿，关注我，收看每期的编程干货。

一个简单的库，也许能够开启我们的智慧之门，
一个普通的方法，也许能在危急时刻挽救我们于水深火热，
一个新颖的思维方式，也许能激发我们无尽的创造力，
一个独特的技巧，也许能成为我们的隐形盾牌……

神奇的 Python 库之旅，第 13 章

一、初识 Jira

Jira 是 Atlassian 公司开发的一款项目和任务管理工具。它广泛应用于软件开发、IT 支持、营销等各个领域。Jira 的灵活性和强大的功能使得它成为许多团队的首选。

为什么选择 Jira？

• 强大的项目管理功能：Jira 支持多种项目管理方法，包括敏捷开发、Scrum、看板等。
• 灵活的任务跟踪：可以自定义工作流程、字段和界面，以满足不同团队的需求。
• 丰富的集成：可以与多种工具和平台集成，如 Confluence、Bitbucket、GitHub 等。
• 强大的报告和分析功能：提供多种报告和仪表盘，帮助团队更好地了解项目进展。
  
  

二、安装与配置

安装 jira 库
要使用 Python 与 Jira 进行交互，我们需要先安装 jira 库。使用 pip 进行安装非常简单：

pip install jira

配置 Jira 访问
在开始使用 jira 库之前，我们需要配置 Jira 访问。确保你有一个 Jira 账户，并获取 API token。

获取 API token：

• 登录到你的 Jira 账户。
• 前往 Atlassian API tokens 页面。
• 创建一个新的 API token，并保存它

配置 Python 环境：
在你的 Python 代码中，使用你的 Jira 账户信息和 API token 进行配置。

from jira import JIRA

# Jira 服务器地址
jira_server = 'https://your-domain.atlassian.net'

# Jira 账户信息
jira_options = {
   
   
    'server': jira_server
}
jira = JIRA(options=jira_options, basic_auth=('[email protected]', 'your-api-token'))

现在，我们已经完成了 Jira 的配置，可以开始与 Jira 进行交互了。

三、基本操作

创建项目
让我们从创建一个新的 Jira 项目开始。创建项目需要管理员权限，因此确保你的账户有足够的权限。

# 创建一个新的 Jira 项目
project_key = 'TEST'
project_name = 'Test Project'
project_description = 'This is a test project created by Python script.'

project = jira.create_project(key=project_key, name=project_name, template_name='Software', description=project_description)

print(f'项目 {
     
     project_name} 创建成功，项目键为 {
     
     project_key}')

创建任务
在 Jira 中，任务是最基本的工作单元。让我们创建一个新的任务。

# 创建一个新的任务
issue_dict = {
   
   
    'project': {
   
   'key': 'TEST'},
    'summary': '这是一个测试任务',
    'description': '通过 Python 创建的测试任务',
    'issuetype': {
   
   'name': 'Task'},
}

new_issue = jira.create_issue(fields=issue_dict)

print(f'任务 {
     
     new_issue.key}