jira的命令行界面
项目描述
Jira命令行界面
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创建了一个新问题。问题类型是开发缺陷,标签是abc和def,组件是xxx和yyyy
./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 的散列值
算法 | 散列摘要 | |
---|---|---|
SHA256 | 21568862b00ca8ef8912e8b6f018d3c3db578b7a1704c43077b1e4ac6fcef943 |
|
MD5 | bb0e4ce02dd6e4e2a7c761e1c8000c4e |
|
BLAKE2b-256 | 75024ab7dea838781f67bb56bb9917548bbc74ae6545fc863fbd713dd60eedf2 |