rtcclient 0.6.0

关于这个图书馆

ibm®rational team concert™构建在jazz平台上，允许 应用程序开发团队使用一个工具跨团队、跨代码、跨， 跑站立，计划冲刺，跟踪工作有关更多信息，请参阅 到here。

重要提示：这不是官方发布的基于python的rtc客户端。

这个库可以帮助您：

• 与RTC服务器交互以检索包含详细信息/配置的对象，包括Project area、Team area、Workitems等
通过自定义的模板或现有的^ {STR 1 }工作项；创建各种类型的^ {STR 1 } $Workss<强>
• 对检索到的Workitems执行一些操作，包括get/addComments、get/add/removeSubscribers/Children/Parent、get/uploadAttachments等
• 使用指定的筛选规则或直接从保存的查询中查询Workitems
• 记录操作过程中的所有活动和消息；

Python&Rational团队音乐会版本

该项目已针对Rational Team Concert5.0.1进行了测试， 5.0.2和6.0在python 2.6、2.7和3.3上。

重要链接

支持和错误报告： https://github.com/dixudx/rtcclient/issues?q=is%3Aopen+sort%3Acomments-desc

项目源代码：https://github.com/dixudx/rtcclient

项目文档：https://readthedocs.org/projects/rtcclient/

安装

要安装rtcclient，只需：

$ pip install rtcclient

示例

rtcclient用于映射rtc中的对象（例如，项目区域， 团队区域，工作项）到易于管理的python对象中：

>>>fromrtcclient.utilsimportsetup_basic_logging>>>fromrtcclientimportRTCClient# you can remove this if you don't need logging# default debug logging for console output>>>setup_basic_logging()# url ends with jazz>>>url="https://your_domain:9443/jazz">>>username="your_username">>>password="your_password"# if your rtc server is behind a proxy, remember to set "proxies"# explicitly. detailed can be found in quick start of the doc# if your url ends with ccm, set ends_with_jazz to False# refer to issue #68 for detailed explanation>>>myclient=RTCClient(url,username,password,ends_with_jazz=True)# it will be faster if returned properties is specified# see in below query example>>>wk=myclient.getWorkitem(123456)# get a workitem whose id is 123456# get all workitems# If both projectarea_id and projectarea_name are None, all the workitems# in all ProjectAreas will be returned>>>workitems_list=myclient.getWorkitems(projectarea_id=None,projectarea_name=None)>>>myquery=myclient.query# query class>>>projectarea_name="your_projectarea_name"# customize your query string# below query string means: query all the workitems with title "use case 1">>>myquerystr='dc:title="use case 1"'# specify the returned properties: title, id, state, owner# This is optional. All properties will be returned if not specified>>>returned_prop="dc:title,dc:identifier,rtc_cm:state,rtc_cm:ownedBy">>>queried_wis=myquery.queryWorkitems(query_str=myquerystr,projectarea_name=projectarea_name,returned_properties=returned_prop)

测试

建议使用virtualenv。setuptools将自动获取 缺少测试依赖项。

如果已经在系统上安装了tox，则可以运行 使用pytest和以下命令进行测试：

virtualenv
source .venv/bin/active
(venv) tox -e py27
(venv) tox -e py33
(venv) tox -e pep8