跳转到主要内容

jira的命令行界面

项目描述

Jira命令行界面

https://travis-ci.org/toabctl/jiracli.svg

jiracli是一个基于jira模块的简单命令行界面。该模块使用REST API与Jira实例进行通信。

安装

需要python2.7和来自https://pypi.python.org/pypi/jira/jira

  • 您可以在虚拟环境中使用pip安装jiracli

    virtualenv myenv
    source myenv/bin/activate
    pip install jiracli
  • 或不在虚拟环境中

    pip install jiracli
  • 或直接从提取的源中

    python setup.py install

配置

在第一次运行时,jiracli会要求输入用户名、密码和Jira URL。所有值都存储在~/.jiracli.ini中。如果从配置文件中删除密码键,则每次都会要求输入密码。

配置文件中可以设置一些可选配置选项

verify

默认为“true”。如果设置为“false”,则在与JIRA服务器通信时将禁用证书验证。

用法

尝试使用以下命令获取帮助

./jiracli -h

示例:创建一个新问题

以下命令为项目PROJECT创建了一个新问题。问题类型是开发缺陷,标签是abcdef,组件是xxxyyyy

./jiracli  -c PROJECT "Dev Bug" "my test summary" "abc,def" "xxx,yyyy"

示例:显示单个问题

以下命令打印单个问题

./jiracli -i PROJECT-3535
PROJECT-3535, Prod Bug: This is a terrible bug. (Created, Low)
created              : Thu Oct 24 09:30:35 2013, by t.bechtold
assignee             : t.bechtold
updated              : Fri Nov  8 15:56:27 2013
components           : SITE:XYZ
labels               : mylabel
attachment           :

您还可以提供问题列表。然后,将打印所有问题。要查看问题描述,请使用–issue-desc。要列出评论,请使用–issue-comments。要获取简短概述(每问题在线),请使用–issue-oneline

示例:使用喜欢的过滤器

要查看当前登录用户的常用过滤器,请执行以下操作:

$ ./jiracli --filter-list-fav
23905, t.bechtold PROJECT bugs
Url                  : https://example.com/jira/secure/IssueNavigator.jspa?mode=hide&requestId=23905
description          : Bugs of t.bechtold in project PROJECT
owner                : t.bechtold
jql                  : project = PROJECT AND asignee = t.bechtold

过滤器标题行中的数字 23905 是过滤器ID。此ID用于搜索此过滤器的相关问题。

./jiracli --issue-search-by-filter 23905

此命令简单地执行由过滤器提供的搜索字符串。

示例:使用 jql 进行搜索

使用 Jira 查询语言进行搜索非常简单

./jiracli --issue-search "assignee=CurrentUser() and status='Closed'" --issue-comments

此命令搜索当前登录用户的所有已关闭问题。该命令还会打印每个问题的评论。

示例:添加和删除问题监视者

要了解问题上是否有所变化,可以设置监视者。以下命令用于添加和删除监视者

./jiracli --issue-watch-add PROJECT-1234
./jiracli --issue-watch-remove PROJECT-1234

示例:添加和删除标签

添加和删除标签非常简单。首先添加一个名为 testlabel 的标签,然后将其删除

./jiracli --issue-label-add PROJECT-3724 "testlabel"
./jiracli --issue-label-remove PROJECT-3724 "testlabel"

示例:添加和删除组件

可以使用以下命令查看给定项目的可用组件列表:

./jiracli  --project-list-components PROJECT

现在,将给定列表中的一个组件添加到问题中,然后删除它

./jiracli --issue-component-add PROJECT-1234 "COMP1"
./jiracli --issue-component-remove PROJECT-1234 "COMP1"

示例:添加和删除问题修复版本

这是一个简单的任务,类似于标签或组件

./jiracli --issue-fix-version-add PROJECT-3750 "My Fix version"
./jiracli --issue-fix-version-remove PROJECT-3750 "My Fix version"

示例:向问题添加评论

以下命令将打开文本编辑器以插入评论

./jiracli --issue-comment-add PROJECT-3724

简短的形式是

./jiracli --issue-comment-add PROJECT-3724 -m "another comment"

示例:一次创建多个票证

使用一个简单的纯文本文件,每行包含一个问题的摘要,您可以轻松地在一次运行中创建多个问题和子任务。

文件布局非常简单

  • 每行代表一个问题

  • 此行将是问题的摘要

  • *- 字符开头的问题将是上一个父问题的子任务

示例

As a DevOps I want to automate all daily duties via a RESTful API
* Collect requirments from all DevOps teams
* Design RESTful API draft
* Implement the API

以下命令将根据给定文件中的摘要创建多个票证

./jiracli --issues-create PROJECT "User Story" "Sub-task" sprint22-stories.txt

将文件中的子任务或子票证追加到具有给定父ID的现有问题中

./jiracli --issue-parent PROJECT-3763 --issues-create PROJECT "User Story" "Sub-task" sprint22-stories.txt

示例:显示项目的当前进行中的冲刺

以下命令将显示项目的当前进行中的冲刺

./jiracli --sprint MYPROJECT
issue    status          assignee    summary
-------  --------------  ----------  -------------------------------------------
RD-1547  In Progress     user_owner  Bug on main screen of MyLittlePoney Project
RD-1517  Refused         Nobody      Please add a green poney
RD-1516  Resolved        user_x      My poney is not pink enough

示例:分配问题

以下命令将问题分配给指定的用户

./jiracli --issue-assign DOCUMENT-628 t.bechtold

贡献

jiracli 存放在 github 上。请在那里发送拉取请求或创建问题。

测试

tox 用于测试。要执行例如 pep8 样式检查,请运行

tox -epep8

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源分发

jiracli-0.4.12.tar.gz (28.6 kB 查看散列值)

上传时间

支持