txbugzilla 2.1.0

简单示例：获取一个bug

from txbugzilla import connect, BugzillaException
from twisted.internet import defer
from twisted.internet.task import react

@defer.inlineCallbacks
def example(reactor):
    # connect() defaults to https://bugzilla.redhat.com/xmlrpc.cgi
    bz = yield connect()

    # fetch a bug
    try:
        bug = yield bz.get_bug_simple(10000)
        print(bug.summary)
    except BugzillaException as e:
        print(e)

if __name__ == '__main__':
    react(example)

示例：认证

默认情况下，连接到Bugzilla是匿名的，因此您无法执行像更新bug或查看私有bug或私有信息等有趣的事情。如果您希望认证您的Bugzilla连接，可以向connect()传递一个API密钥。connect()返回的deferred将触发一个带有认证连接的回调。

from txbugzilla import connect
from twisted.internet import defer

@defer.inlineCallbacks
def example():
    # Authenticate with an API key
    bz = yield connect(api_key='123456abcdef')

    # Do something as this logged-in user, for example:
    # bug = yield bz.getbugsimple(...)

(txbugzilla的早期版本支持旧的用户名/密码和令牌方法进行认证。这些方法已在Bugzilla 5中弃用，且txbugzilla的最新版本不再支持这些方法。您现在必须使用API密钥。)

$ cat ~/.config/python-bugzilla/bugzillarc
[bugzilla.redhat.com]
api_key=ABCDEFGHIJK

示例：分配错误

这肯定会赢得朋友。

from txbugzilla import connect, BugzillaException
from twisted.internet import defer

@defer.inlineCallbacks
def example():
    bz = yield connect(api_key='123456abcdef')

    try:
        result = yield bz.assign(1234, 'someone@redhat.com')
        if result:
           print('assigned bz #1234 to someone@redhat.com')
        else:
           print('bz #1234 is already assigned to someone@redhat.com')
    except BugzillaException as e:
        print(e)

示例：使用上游错误搜索

快速找到“BZ与哪个外部跟踪器票据匹配？”

from txbugzilla import connect, BugzillaException
from twisted.internet import defer

@defer.inlineCallbacks
def example():
    bz = yield connect()
    try:
        result = yield bz.find_by_external_tracker(
            'http://tracker.ceph.com', '16673')
        for b in result:
            print(b.weburl + ' ' + b.summary)
    except BugzillaException as e:
        print(e)

示例：原始XML-RPC调用

想使用这里未提及的某些 API 调用？ 使用 call() 方法进行原始XML-RPC调用。它还会为您处理API密钥认证。

例如，查看您是其中一员的全部组列表

from txbugzilla import connect, BugzillaException
from twisted.internet import defer
from pprint import pprint

@defer.inlineCallbacks
def example():
    bz = yield connect(api_key='123456abcdef')

    try:
        result = yield bz.call('User.get', {'names': [bz.username],
                                            'include_fields': ['groups']})
        pprint(result['users'][0]['groups'])
    except BugzillaException as e:
        print(e)

许可证

MIT（参见 LICENSE）

使用此包的包

• helga-bugzilla