2013年3月 总版技术专家分月排行榜第二
2014年2月 Java大版内专家分月排行榜第一2013年8月 Java大版内专家分月排行榜第一2013年5月 Java大版内专家分月排行榜第一2013年4月 Java大版内专家分月排行榜第一2013年3月 Java大版内专家分月排行榜第一2013年2月 Java大版内专家分月排行榜第一
2013年3月 总版技术专家分月排行榜第二
2014年2月 Java大版内专家分月排行榜第一2013年8月 Java大版内专家分月排行榜第一2013年5月 Java大版内专家分月排行榜第一2013年4月 Java大版内专家分月排行榜第一2013年3月 Java大版内专家分月排行榜第一2013年2月 Java大版内专家分月排行榜第一
2007年5月 其他开发语言大版内专家分月排行榜第二
本帖子已过去太久远了，不再提供回复功能。jira-python模块的功能介绍和一些基础的翻译。 - 推酷
jira-python模块的功能介绍和一些基础的翻译。
最近要研究zabbix配合jira创建一些工单，方便对一些问题进行跟进和记录。
jira API在5.0开始启用，然后搜了下，有相关的API模块，因为依赖关系要下一些被屏蔽的地址上的包，国内如果需要装这个包需要翻墙，或者相关包下载下来本地setup。
下面为jira-python的一些翻译，会不定时的更新。有建议请留言，谢谢。
呈现出来的文档满足基本用法是足够了，如果需要后边更详细的一些操作，请访问我的博客地址，
&后面的翻译有点多，这里找不到传附件的地址。。
jira-python
这个文档详细描述了
jira-python
版本的，他是一个
的库，可以让你更简单的使用
JIRA REST API
同样支持一些基本的
GreenHopper
源代码地址：
Version 0.13 ? April 10, 2013
This is the first release driven by the community andfueled by its contributions. Many thanks to Markus Wiik, Sorin Sbarnea, MattDoar, Doug Johnston, Greg Warner, Mark Egan-Fuller, Diogo Campos, and RandallHunt for the feature work and bug-squishing that made such a terrific releasepossible!
（俗称，来源，感谢语。）
Requests 1.0
引入，包括支持
支持基本的
GreenHopper REST API.
python-magic
imghdr, mimetypes
Addedoptional
parameter to
add_attachment
Addedability to pass a
parameter to the requests session.
search_issues
dashboards
now returna
ResultList
which includes some search metadata.
，现在会返回一个结果列表）
各种错误的修正
(issues #5, #7, #8 and #11)
Version 0.12 ? August 6, 2012
Reworkedcontent-type usage to play nice with OAuth in JIRA 5.1.
Madeinterpretation and display of error messages more meaningful.
Implementeda config file for JIRA Shell.
Update toRequests 0.13.6 and IPython 0.13.
Known issues
授权时，创建不了项目和用户头像。
最简单的安装
jira-python
的方法是通过
$ pip install jira
如果你要运行客户端的独立，我们强烈建议您使用的
virtualenv
，安装方法如下：
$ pip -E jira_python install jira
$ workon jira_python
这样做可以创建一个私有的
“安装”，你可以自由升级，降级或中断，不会把你的系统的相关组件处于危险中。
源代码包（支持
的都支持。
python-requests
处理相关请求，通常情况下发布的版本必须依赖最新版本，写文档时，该版本是
的版本应该都行。
requests-oauthlib
，写这篇文章时最新版本为
解释器关于
的一些使用问题，写这篇文章的时候，版本是
该库自动检测一些内容的类型，如上传图片等。他在系统上工作仅仅提供
基本上都会预装这个库，但是
来处理，你如果你的系统没有它，你必须手动指定他的内容格式，例如项目和用户的创建。
实现，处理密钥签名。它是用来帮助实现
这是需要使用的
。请注意，它不是自动安装，因为它是在
中一个相当繁琐的过程。在
pip install pycrypto
应该这样做。
安装时注意依赖关系
这里是一个简单的使用例子
这个脚本展示了如何使用
jira.client
默认情况下，客户端从
中启用了实例去连接
/display/DOCS/Installing+the+Atlassian+Plugin+SDKfor details).
来查看其默认参数
JIRA(options)
获取所有的匿名用户可查看的项目。
projects()
排序可用的项目键，然后返回第二个，第三个和第四个键。
projects])
'JRA-1330'
上获取所有
By Atlassians
atl_comments
emailAddress
上增加一个评论
add_comment(issue
'Comment text'
) and description(
update(summary
&I'mdifferent!&
description
'Changed the summary to be different.'
你可以像这样更新整个标签，
update(labels
或修改现有标签的列表。新的标签是
的，不带空格
u'new_text'
update(fields
# Send the issue away for good.
：不太确定）
另外一个例子展示如何使用你的用户，密码验证登陆
这个脚本展示了如何使用账号密码通过
HTTP BASIC
认证方式连接
jira.client
默认情况下，客户端从
中启用了实例去连接
/display/DOCS/Installing+the+Atlassian+Plugin+SDKfor details.
JIRA(basic_auth
密码的元祖
获取此服务器的可变的应用性能（需要
系统管理员用户的权限）
application_properties()
找出所有关于
的报告（代理人或者是开发者是
search_issues
'assignee=admin'
找出前三个（报告人是）
collections
Counter([issue
most_common(3)
这个例子展示如何使用
GreenHopper
这个脚本展示了如何使用客户端通过匿名模式
from six import print_ as print
from jira.client import GreenHopper
默认情况下，客户端从
中启用了实例去连接
/display/DOCS/Installing+the+Atlassian+Plugin+SDKfor details).
来查看相关的参数
options = {
& 'server': ''
gh = GreenHopper(options)
获取所有匿名用户可见的版图。
boards = gh.boards()
）具体的版面中查看信息
board_id = 441
print(&GreenHopper board: %s(%s)& % (boards[0].name, board_id))
sprints = gh.sprints(board_id)
列出不完整的
for sprint in sprints:
& sprint_id = sprint.id
& print(&Sprint: %s& % sprint.name)
& incompleted_issues = gh.incompleted_issues(board_id, sprint_id)
& print(&Incomplete issues: %s& % ', '.join(issue.key for issuein incompleted_issues))
Quickstart
（快速入门）
Initialization
（初始化）
所有操作通过
的对象，所以做一个：
jira.client
这个链接通过
http://localhost:2990/jira
这个地址链接到
他将使用从
启用实例链接上面的地址。
你可以手动指定这个
JIRA(options
Authentication
在初始化的时候，
jira-python
模块能够创建一个
HTTP BASIC
OAuth 1.0a
去取得一个令牌用于认证。这个会话将会应用到所有关于
对象的连接。
HTTP BASIC
传递一个参数：元祖
basic_auth &
（构造函数）
authed_jira
JIRA(basic_auth
'username'
'password'
传递一个参数（字典）给
所有的值都是样品，不会在你的代码工作！
key_cert_data
open(key_cert, 'r')
key_cert_file:
& &key_cert_data
key_cert_file
oauth_dict
'access_token'
'd87f3hajglkjh89a97f8'
'access_token_secret'
'a9f8ag0ehaljkhgeds90'
'consumer_key'
'jira-oauth-consumer'
'key_cert'
key_cert_data
authed_jira
JIRA(oauth
oauth_dict)
使用的前提：令牌必须通过授权、必须通过
。在交互使用中，如果你没有有效的令牌，
可以帮助你
没有默认安装，详情请见依赖关系章节。
访问令牌和令牌密钥相对于用户具有唯一性。
Consumerkey
的配置相匹配。
密钥证书的数据必须是在
提供者配置的公钥匹配的私钥。
for details on configuring an OAuth provider for JIRA
（了解更多）
你可以通过
的对象（标号）拿到相应的
issue('JRA-1330')
将自动封装到
的对象中，方便你直接访问信息：
字段级安全权限
# 440 (at least)
如果你只想要几个特定的信息，为了节省时间，你可以声明它们：
'JRA-1330'
'summary,comment'
重新分配的问题：
分配相关的权限，（这个不同于编辑权限）。
assign_issue(issue
'newassignee'
create_issue(project
'New issue from jira-python'
description
'Look into this one'
或者使用字典创建它们：
issue_dict
'New issue from jira-python'
'description'
'Look into this one'
'issuetype'
create_issue(fields
issue_dict)
, description
and issue type
这几个在创建
总是必须的。
如果你创建
需要设置其他的一些信息
jira.createmeta
方法获取相关信息。
同样，你可以通过相关参数更新
'new summary'
description
'A new summary was added'
'new_user'
重新分配更新问题所需要的编辑权限
或者使用字典来操作：
update(fields
'new summary'
'description'
'A new summarywas added'
如果你完成了创建
，你可以通过下面来让他写入硬盘（保存、退出）
来快速找到你想要的
issues_in_proj
search_issues(
'project=PROJ'
all_proj_issues_but_mine
search_issues
'project=PROJ andassignee != currentUser()'
我应该在本周完成的
（优先级排序）
search_issue
'assignee = currentUser() and due & endOfWeek() orderby priority desc'
maxResults
# Summaries of my last 3 reported issues
我的最后三个
报告的总结
search_issues
'reporter =currentUser() order by created desc'
maxResults
一样，都是对象。可以通过父
的对象或者
对象的专用方法获得：
comments_a
comments_b
comments(issue
# comments_b ==comments_a
如果你知道
可以获取个别评论：
'JRA-1330'
添加、编辑、删除评论同样也是随意的：
add_comment
'JRA-1330'
'new comment'
# no Issue object required
add_comment
'new comment'
visibility
'Administrators'
# foradmins only
'updated commentbody'
Transitions
（切换问题处理用户）
是否可以切换：
transitions
transitions(issue)
transitions
# [(u'5', u'Resolve Issue'), (u'2', u'Close Issue')]
仅适用于当前已经验证的用户的切换！。
对一个问题进行切换
解决这个问题之后再将其付给下一个用户进行相关操作
jira.transition_issue(issue, '5',assignee={'name': 'pm_user'}, resolution={'id': '3'})
# The above line is equivalent to
相当于上边的行
jira.transition_issue(issue, '5', fields: {'assignee':{'name':'pm_user'}, 'resolution':{'id': '3'}})
项目也是对象。。
projects()
Also, just like issue objects, project objects areaugmented with their fields:
的对象一样，
的对象也会增强
他们的内容：（
project('JRA')
name & & & & & & & &
displayName
# 'Paul Slade [Atlassian]'
如果你有权限，你可以获取组件、版本以及任何一角色的信息
components
project_components(jra)
components] &
# 'Accessibility', 'Activity Stream', 'Administration',etc.
project_roles(jra) &
# 'Administrators', 'Developers', etc.
project_versions(jra)
reversed(versions)]
# '5.1.1', '5.1', '5.0.7', '5.0.6', etc.
这里没有太多的演示。如果要真正了解一个服务，就必须探索他，使用它。试验和解决错误，一个
的设计特别适合积极的探索。
在命令行运行它
$ jirashell -s
&JIRA Shell()&
*** JIRA client is in 'jira'.Press Ctrl-D to exit.
这是一个专门的
翻译（建立在
基础上），让你了解
服务。它接受任何合法的
构建了一个客户端（在接受参数的基础上），并且将其存储在
In [1]: issue = jira.issue('JRA-1330')
包含的方法可以通过
In [2]: issue.
issue.delete &issue.fields issue.id & & &issue.raw & & issue.update
issue.expand &issue.find & issue.key & & issue.self
In [2]: issue.fields.
issue.fields.aggregateprogress & & & & & & &issue.fields.customfield_11531
issue.fields.aggregatetimeestimate & & & & &issue.fields.customfield_11631
issue.fields.aggregatetimeoriginalestimate &issue.fields.customfield_11930
issue.fields.aggregatetimespent & & & & & & issue.fields.customfield_12130
issue.fields.assignee & & & & & & & & & & &issue.fields.customfield_12131
issue.fields.attachment & & & & & & & & & & issue.fields.description
ment & & & & & & & & & & & issue.fields.environment
ponents & & & & & & & & & & issue.fields.fixVersions
issue.fields.created & & & & & & & & & & & &issue.fields.issuelinks
issue.fields.customfield_10150 & & & & & & &issue.fields.issuetype
issue.fields.customfield_10160 & & & & & & &issue.fields.labels
issue.fields.customfield_10161 & & & & & & &issue.fields.mro
issue.fields.customfield_10180 & & & & & & &issue.fields.progress
issue.fields.customfield_10230 & & & & & & &issue.fields.project
issue.fields.customfield_10575 & & & & & & &issue.fields.reporter
issue.fields.customfield_10610 & & & & & & &issue.fields.resolution
issue.fields.customfield_10650 & & & & & & &issue.fields.resolutiondate
issue.fields.customfield_10651 & & & & & & &issue.fields.status
issue.fields.customfield_10680 & & & & & & &issue.fields.subtasks
issue.fields.customfield_10723 & & & & & & &issue.fields.summary
issue.fields.customfield_11130 & & & & & & &issue.fields.timeestimate
issue.fields.customfield_11230 & & & & & & &issue.fields.timeoriginalestimate
issue.fields.customfield_11431 & & & & & & &issue.fields.timespent
issue.fields.customfield_11433 & & & & & & &issue.fields.updated
issue.fields.customfield_11434 & & & & & & &issue.fields.versions
issue.fields.customfield_11435 & & & & & & &issue.fields.votes
issue.fields.customfield_11436 & & & & & & &issue.fields.watches
issue.fields.customfield_11437 & & & & & & &issue.fields.workratio
Resource Objects and Properties
属性的资源）
资源和属性：
之间的区别库。
资源实际上指的是服务器当前的
实体的状态，例如，“
的管理概念，它可以被看做是获得资源的网址：
jira-python
中，资源是资源项目（或他的子类）中的实例，只能从
方法中的服务器中获得。并且资源可以连接到其他的资源中。
所有资源都有一个自己的链接：称为根级属性，它包含的资源来源于网址。
一个资源连接到其他资源，并在客户端保存该连接。
在上边的例子中，
issue.fields.assignee
中不仅仅是个字典，它是一个完整的资源对象。
properties object
is a collection ofvalues returned by JIRA in response to some query from the REST API. Theirstructure is freeform and modeled as a Python dict. Client methods return thisstructure for calls that do not produce resources. For example, the propertiesreturned from the URL
http://jira-server/rest/api/2/issue/createmeta
aredesigned to inform users what fields (and what values for those fields) arerequired to successfully create issues in the server’s projects. Since theseproperties are determined by JIRA’s configuration, they are not resources.
Properties
的一些查询返回的值的集合。
其结构是自由形式和建模为一个
客户端方法返回这个结构不产生资源的调用。
举例来说，从性能
http://jira-server/rest/api/2/issue/createmeta
旨在告知哪些字段（和什么样的价值观对那些字段）都必须在服务器的成功创建问题的用户的
返回项目。
由于这些属性是由
的配置决定，他们不是资源。
的客户端的方法记录它们是否会返回一个资源或对象的属性。
Contributing
客户端是在
许可下的一个开源项目。任何种类的欢迎踊跃投稿！
Discussion
我们鼓励所有愿意使用“
”标签的人到
已发表评论数()
请填写推刊名
描述不能大于100个字符!
权限设置： 公开
仅自己可见
正文不准确
标题不准确
排版有问题
主题不准确
没有分页内容
图片无法显示
视频无法显示
与原文不一致Please enable JavaScript to view the
Top 10 Issues
01. 02. 03. 04. 05. 06. 07. 08. 09. 10.
Popular Subjects& & & & & & & & & & & & & & & & & & & & Latest Issues& & & & & & & & & &
&&&& &&&&0.006}