| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/lib/python2.6/site-packages/bugzilla/ |
Upload File : |
Ic @ sm d d k Z d d k l Z d d k Z d d k Z d e i i f d YZ d e e f d YZ d S( iN( t
Bugzilla34t
RHBugzillac B sN e Z d Z d Z e i i d e Z d Z d Z d Z d Z
d Z d Z d Z
d
Z d Z d! d Z d
Z d Z d Z d Z d Z e d d d d Z d e e e d Z d Z d Z d Z d e d Z d Z d Z d Z d Z! d Z" d Z# d Z$ d Z% RS(" s Concrete implementation of the Bugzilla protocol. This one uses the
methods provided by Red Hat's Bugzilla 2.18 variant.
RHBugzilla supports XMLRPC MultiCall. The methods which start with a
single underscore are thin wrappers around XMLRPC methods and should thus
be safe for multicall use.
Documentation for most of these methods can be found here:
https://bugzilla.redhat.com/docs/en/html/api/extensions/compat_xmlrpc/code/webservice.html
s 0.2s RHBugzilla/%sc K s) t i i i | | | i i | _ d S( N( t bugzillat baset BugzillaBaset __init__t __class__t
user_agent( t selft kwargs( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyR s c C s | i i i | | S( s$ Backend login method for RHBugzilla.( t _proxyR t login( R t usert password( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _login# s c C s t S( s% Backend logout method for RHBugzilla.( t True( R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _logout' s c s@ t i | t i | i _ f d } | _ S( s This returns kind of a mash-up of the Bugzilla object and the
xmlrpclib.MultiCall object. Methods you call on this object will be
added to the MultiCall queue, but they will return None. When you're
ready, call the run() method and all the methods in the queue will be
run and the results of each will be returned in a list. So, for example:
mc = bz._multicall()
mc._getbug(1)
mc._getbug(1337)
mc._query({'component':'glibc','product':'Fedora','version':'devel'})
(bug1, bug1337, queryresult) = mc.run()
Note that you should only use the raw xmlrpc calls (mostly the methods
starting with an underscore). Normal getbug(), for example, tries to
return a _Bug object, but with the multicall object it'll end up empty
and, therefore, useless.
Further note that run() returns a list of raw xmlrpc results; you'll
need to wrap the output in Bug objects yourself if you're doing that
kind of thing. For example, Bugzilla.getbugs() could be implemented:
mc = self._multicall()
for id in idlist:
mc._getbug(id)
rawlist = mc.run()
return [_Bug(self,dict=b) for b in rawlist]
c s
i i S( N( R
t results( ( t mc( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt runN s ( t copyt xmlrpclibt MultiCallR
R ( R R ( ( R s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt
_multicall0 s
c C s | i i i S( N( R
R t getBugFields( R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt
_getbugfieldsS s c C s | i i i S( N( R
R t getQueryInfo( R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt
_getqueryinfoU s c C sk | i i i } d } g } xF | i D]8 \ } } | i h | d 6| d 6| d 6 | d 7} q+ W| S( s Backend _getproducts method for RH Bugzilla. This predates the
Bugzilla3 Products stuff, so we need to massage this data to make it
fit the proper formati t idt namet descriptioni ( R
R t getProdInfot iteritemst append( R t rt nt prodR t desc( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _getproductsW s
"c C s9 t | t j o | i | } n | i i i | S( N( t typet intt _product_id_to_nameR
R t getProdCompInfo( R t product( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _getcomponentsc s c C s9 t | t j o | i | } n | i i i | S( N( R' R( R) R
R t getProdCompDetails( R R+ ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _getcomponentsdetailsg s c C s | i } | i | i | i | o | i | | i | n | i } | i d \ | _ | _ | i d | _
| i d | _ | o0 | i d | i | <| i d | i
| <n d S( s This is a convenience method that does getqueryinfo, getproducts,
and (optionally) getcomponents in one big fat multicall. This is a bit
faster than calling them all separately.
If you're doing interactive stuff you should call this, with the
appropriate product name, after connecting to Bugzilla. This will
cache all the info for you and save you an ugly delay later on.i N( R R R& R R, R. R t popt
_querydatat _querydefaultst _productst
_bugfieldst _componentst _components_details( R R+ R R" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _get_infok s
c C s | i i i | S( s3 Return a dict of full bug info for the given bug id( R
R t getBug( R R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _getbug s c C sK | i i i | } | o' d | j o t i d d | n | Sd S( s; Return a short dict of simple bug info for the given bug idt bug_idt Servers Could not load bug %sN( R
R t getBugSimpleR t Fault( R R R" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt
_getbugsimple s c C sI | i } x | D] } | i | q W| i } ~ t i i | S( s Like _getbug, but takes a list of ids and returns a corresponding
list of bug objects. Uses multicall for awesome speed.( R R8 R R R t replace_getbug_errors_with_None( R t idlistR R t raw_results( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _getbugs s c C sI | i } x | D] } | i | q W| i } ~ t i i | S( s Like _getbugsimple, but takes a list of ids and returns a
corresponding list of bug objects. Uses multicall for awesome speed.( R R= R R R R> ( R R? R R R@ ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _getbugssimple s c C s | i i i | S( s Query bugzilla and return a list of matching bugs.
query must be a dict with fields like those in in querydata['fields'].
Returns a dict like this: {'bugs':buglist,
'displaycolumns':columnlist,
'sql':querystring}
buglist is a list of dicts describing bugs. You can specify which
columns/keys will be listed in the bugs by setting 'column_list' in
the query; otherwise the default columns are used (see the list in
querydefaults['default_column_list']). The list of columns will be
in 'displaycolumns', and the SQL query used by this query will be in
'sql'.
( R
R t runQuery( R t query( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _query s
t c C s+ | i i i | | | i d | | | | S( s Add a comment to the bug with the given ID. Other optional
arguments are as follows:
private: if True, mark this comment as private.
timestamp: comment timestamp, in the form "YYYY-MM-DD HH:MM:SS"
worktime: amount of time spent on this comment (undoc in upstream)
bz_gid: if present, and the entire bug is *not* already private
to this group ID, this comment will be marked private.
RF ( R
R t
addCommentR ( R R t commentt privatet timestampt worktimet bz_gid( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _addcomment s
c C s+ | i i i | | | i d | | | | S( s Set the status of the bug with the given ID. You may optionally
include a comment to be added, and may further choose to mark that
comment as private.
The status may be anything from querydefaults['bug_status_list'].
Common statuses: 'NEW','ASSIGNED','MODIFIED','NEEDINFO'
Less common: 'VERIFIED','ON_DEV','ON_QA','REOPENED'
'CLOSED' is not valid with this method; use closebug() instead.
RF ( R
R t changeStatusR ( R R t statusRH RI t
private_in_itt nomail( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt
_setstatus s c C s1 | i i i | | | i d | | | | | |
S( s Raw xmlrpc call for closing bugs. Documentation from Bug.pm is
below. Note that we drop the username and password fields because the
Bugzilla object contains them already.
closeBug($bugid, $new_resolution, $username, $password, $dupeid,
$new_fixed_in, $comment, $isprivate, $private_in_it, $nomail)
Close a current Bugzilla bug report with a specific resolution. This will eventually be done in Bugzilla/Bug.pm
instead and is meant to only be a quick fix. Please use bugzilla.changesStatus to changed to an opened state.
This method will change the bug report's status to CLOSED.
$bugid
# ID of bug report to add comment to.
$new_resolution
# Valid Bugzilla resolution to transition the report into.
# DUPLICATE requires $dupeid to be passed in.
$dupeid
# Bugzilla report ID that this bug is being closed as
# duplicate of.
# Requires $new_resolution to be DUPLICATE.
$new_fixed_in
# OPTIONAL String representing version of product/component
# that bug is fixed in.
$comment
# OPTIONAL Text string containing comment to add.
$isprivate
# OPTIONAL Whether the comment will be private to the
# 'private_comment' Bugzilla group.
# Default: false
$private_in_it
# OPTIONAL if true will make the comment private in
# Issue Tracker
# Default: follows $isprivate
$nomail
# OPTIONAL Flag that is either 1 or 0 if you want email to be sent or not for this change
RF ( R
R t closeBugR ( R R t
resolutiont dupeidt fixedinRH t isprivateRP RQ ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _closebug s %c K s | i i i | | S( s Raw xmlrpc call to set one of the assignee fields on a bug.
changeAssignment($id, $data, $username, $password)
data: 'assigned_to','reporter','qa_contact','comment'
returns: [$id, $mailresults]( R
R t changeAssignment( R R t data( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _setassignee s c C s g } | d j o | d j n h | d 6| d 6d d 6d d 6} x. | D]& } | | d <| i i i | | qJ Wd | d <x. | D]& } | | d <| i i i | | q Wd S( s update the deps (blocked/dependson) for the given bug.
blocked/dependson: list of bug ids/aliases
action: 'add' or 'delete'
RHBZ call:
updateDepends($bug_id,$data,$username,$password,$nodependencyemail)
#data: 'blocked'=>id,'dependson'=>id,'action' => ('add','remove')
RHBZ only does one bug at a time, so this method will loop through
the blocked/dependson lists. This may be slow.
t deletet removeR t actionRF t blockedt dependsonN( R
R t
updateDepends( R R R_ R` R^ R" RZ t bt d( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _updatedeps s
"
c C ss | d j o
d } n | d j o
d } n h | d 6| d 6d i | d 6| d 6| d
6} | i i i | S( s> Updates the CC list using the action and account list specified.
cclist must be a list (not a tuple!) of addresses.
action may be 'add', 'delete', or 'overwrite'.
comment specifies an optional comment to add to the bug.
if mail is True, email will be generated for this change.
R\ R] t overwritet makeexactR R^ t ,t ccRH RQ ( t joinR
R t updateCC( R R t cclistR^ RH RQ RZ ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _updatecc s
!c C s1 h | d 6| d 6| d 6} | i i i | | S( s Update the whiteboard given by 'which' for the given bug.
performs the given action (which may be 'append',' prepend', or
'overwrite') using the given text.R' t textR^ ( R
R t updateWhiteboard( R R Rm t whichR^ RZ ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _updatewhiteboard& s c C s | i i i | | S( s Updates the flags associated with a bug report.
data should be a hash of {'flagname':'value'} pairs, like so:
{'needinfo':'?','fedora-cvs':'+'}
You may also add a "nomail":1 item, which will suppress email if set.
NOTE: the Red Hat XMLRPC interface does not yet support setting the
requestee (as in: needinfo from smartguy@answers.com). Alas.( R
R t updateFlags( R R t flags( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _updateflags- s c K s | i i i | | S( N( R
R t
addAttachment( R R t
attachdata( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _attachfile> s c K s | i i i | } | d S( s Raw xmlrpc call for createBug() Doesn't bother guessing defaults
or checking argument validity. Use with care.
Returns bug_idi ( R
R t createBug( R RZ R" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt
_createbugC s c C s+ | i i i | | | | i | i } | S( N( R
R t updatePermsR R
( R R R^ t groupsR" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _updatepermsJ s c C s( | i i i | | | i | i } | S( N( R
R t addUserR R
( R R R R" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _adduserN s $c C s d } x8 | D]0 } | | j p | | o t d | q
q
Wt | d t j o | i | d | d <n | i i i | | i | i } | S( NR+ t componentt initialownerR s mandatory fields missing: %s( s products componentR s description( t TypeErrorR' R( R) R
R t addComponentR R
( R RZ t add_required_fieldst fieldR" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt
_addcomponentQ s !c C s d } x8 | D]0 } | | j p | | o t d | q
q
Wt | d t j o | i | d | d <n | i i i | | i | i } | S( NR R+ R~ s mandatory field missing: %s( s initialowners products component( R R' R( R) R
R t
editComponentR R
( R RZ t edit_required_fieldsR R" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _editcomponentZ s !N(& t __name__t
__module__t __doc__t versionR R R R R R R R R R& R, R. t NoneR6 R8 R= RA RB RE t FalseRM RR RX R[ Rd Rl Rp Rs Rv Rx R{ R} R R ( ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyR sB
#
' t RHBugzilla3c B s e Z d Z d Z e i i d e Z d Z d Z d Z d Z
d Z d e e e d Z
d
Z d Z d Z d e d
Z d Z RS( s Concrete implementation of the Bugzilla protocol. This one uses the
methods provided by Red Hat's Bugzilla 3.2+ instance, which is a superset
of the Bugzilla 3.2 methods. The additional methods (Bug.search, Bug.update)
should make their way into a later upstream Bugzilla release (probably 4.0).
Note that RHBZ3 *also* supports most of the old RHBZ methods, under the
'bugzilla' namespace, so we use those when BZ3 methods aren't available.
This class was written using bugzilla.redhat.com's API docs:
https://bugzilla.redhat.com/docs/en/html/api/
By default, _getbugs will multicall getBug(id) multiple times, rather than
doing a single Bug.get(idlist) call. You can disable this behavior by
setting the 'multicall' property to False. This will make it somewhat
faster, but any missing/unreadable bugs will cause the entire call to
Fault rather than returning any data.
s 0.1s RHBugzilla3/%sc K s> t t | i | | i i | _ | i d t | _ d S( Nt multicall( t superR R R R t getR R ( R R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyR z s c C s g } | i o t | d j o | i i i | d g S| i } x! | D] } | i i i | qQ W| i } ~ t i i | } nF | i i i
h | d 6 } g } | d D] } | | d q ~ } | S( Ni i t idst bugst internals( R t lenR
R R7 R R R R> t BugR ( R R? R" R R R@ t _[1]t i( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyRA s
)c C s | i i i | S( s Query bugzilla and return a list of matching bugs.
query must be a dict with fields like those in in querydata['fields'].
You can also pass in keys called 'quicksearch' or 'savedsearch' -
'quicksearch' will do a quick keyword search like the simple search
on the Bugzilla home page.
'savedsearch' should be the name of a previously-saved search to
execute. You need to be logged in for this to work.
Returns a dict like this: {'bugs':buglist,
'sql':querystring}
buglist is a list of dicts describing bugs, and 'sql' contains the SQL
generated by executing the search.
( R
R t search( R RD ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyRE s
c C s! | i i i h | d 6| d 6 S( s Update the given fields with the given data in one or more bugs.
ids should be a list of integers or strings, representing bug ids or
aliases.
updates is a dict containing pairs like so: {'fieldname':'newvalue'}
R t updates( R
R t update( R R R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _update_bugs s c C s | i d | g d | S( s Update a single bug, specified by integer ID or (string) bug alias.
Really just a convenience method for _update_bugs(ids=[id],updates)R R ( R ( R R R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt _update_bug s RF c C s< h | d 6} | o | | d <| | d <n | i | | S( s, Set the status of the bug with the given ID.t
bug_statusRH t commentprivacy( R ( R R RO RH RI RP RQ R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyRR s
c
C s h d d 6| d 6} | o d | d <| | d <n | o | | d <n | o# | | d <| o t | d <qr n | i | | S( s Close the given bug. This is the raw call, and no data checking is
done here. That's up to the closebug method.
Note that the private_in_it and nomail args are ignored.t CLOSEDR RT t DUPLICATEt dupe_idt fixed_inRH R ( R R (
R R RT RU RV RH RW RP RQ R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyRX s
c K sZ t g } | i D]* \ } } | d j o | | | f q q ~ } | i | | S( s Raw xmlrpc call to set one of the assignee fields on a bug.
changeAssignment($id, $data, $username, $password)
data: 'assigned_to','reporter','qa_contact','comment'
returns: [$id, $mailresults]RF ( t dictR R ( R R RZ R t kt vR ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyR[ s Jc C sJ | d j o
t d n h | d | 6| d | 6} | i | | d S( s Update the deps (blocked/dependson) for the given bug.
blocked, dependson: list of bug ids/aliases
action: 'add' or 'delete'
t addR\ s action must be 'add' or 'delete's
%s_blockeds %s_dependsonN( s adds delete( t
ValueErrorR ( R R R_ R` R^ R ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyRd s
c C s h } | o | | d <n | d
j o" | | d | <| i | | nx | d j oa | i | } d | j o t d t | n | i | | d d | i | | d n
t d d S( s> Updates the CC list using the action and account list specified.
cclist must be a list (not a tuple!) of addresses.
action may be 'add', 'delete', or 'overwrite'.
comment specifies an optional comment to add to the bug.
if mail is True, email will be generated for this change.
RH R R\ s %s_ccRe Rh s Can't find cc list in bug %ss- action must be 'add','delete', or 'overwrite'N( s adds delete( R R8 t AttributeErrort strRl R ( R R Rk R^ RH RQ R R" ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyRl s
c C s | i d p | d } n h } | d j o | | | <n | i | } | | j o t d | t | f n | | } | d j o | d | | | <n$ | d j o | d | | | <n | i | | d S( sJ Update the whiteboard given by 'which' for the given bug.
performs the given action (which may be 'append',' prepend', or
'overwrite') using the given text.
RHBZ3 Bug.update() only supports overwriting, so append/prepend
may cause two server roundtrips - one to fetch, and one to update.
t _whiteboardRe s No such whiteboard %s in bug %st prependt R! N( t endswithR8 R R R ( R R Rm Ro R^ R R" t wb( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyRp s
( R R R R R R R R RA RE R R R RR RX R[ Rd Rl Rp ( ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyR d s (
t
bugzilla.baseR t bugzilla3R R R R R R R ( ( ( s7 /usr/lib/python2.6/site-packages/bugzilla/rhbugzilla.pyt <module> s
U