| 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
@ s d d k Z d d k Z y d d k Z Wn e j
o d d k Z n Xd d k Z d d k Z d d k Z d d k Z e i d Z
d Z d e i e f Z
d e f d YZ d e f d YZ d e f d
YZ d Z d e f d
YZ d f d YZ d e i f d YZ d e i e f d YZ d e f d YZ d e f d YZ e Z d S( iNt bugzillas 0.5.1s Python-urllib2/%s bugzilla.py/%st
BugzillaErrorc B s e Z d Z RS( s) Error raised in the Bugzilla client code.( t __name__t
__module__t __doc__( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s t
NeedSyncErrorc B s e Z d Z RS( sM Must save data from this class to the bugzilla server before using this.
( R R R ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s t NeedParamErrorc B s e Z d Z RS( s# A necessary parameter was left out.( R R R ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR % s c C sV g } xI | D]A } t | t o d | j o | i | q
| i d q
W| S( s r is a raw xmlrpc response.
If it represents an error, None is returned.
Otherwise, r is returned.
This is mostly used for XMLRPC Multicall handling.t bug_idN( t
isinstancet dictt appendt None( t rawlistt resultt r( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt replace_getbug_errors_with_None) s t BugzillaBasec B s e Z d Z db db db e i i d d Z d Z d Z d Z
d Z d Z e
e
e e Z db d Z d d
g Z db d Z d Z d
Z d Z db db d Z d Z d Z d Z d Z e d Z e
d d d d Z e d Z e
d d d d Z e
d d d d Z d Z e d Z! e
d d d d! Z" d" Z# d# Z$ d$ Z% d% Z& d& Z' d' Z( e d( Z) e d) Z* e d* Z+ d+ Z, d, Z- d- Z. d. Z/ d/ Z0 d0 Z1 d1 Z2 d2 Z3 d3 Z4 d4 Z5 d5 Z6 d6 Z7 d7 d7 d7 d8 d9 Z8 e d7 d7 d7 d: Z9 d7 e e e d; Z: d< Z; d= Z< d> Z= d7 e d? Z> d@ Z? dA Z@ dB ZA dC ZB dD ZC dE ZD dF ZE dc ZF dd de df dg dh f ZG dV ZH e dW ZI db db db dX ZJ db db dY ZK dZ ZL d[ ZM d\ ZN d] ZO d^ ZP d7 d7 d_ ZQ d` ZR da ZS RS(i sl An object which represents the data and methods exported by a Bugzilla
instance. Uses xmlrpclib to do its thing. You'll want to create one thusly:
bz=Bugzilla(url='https://bugzilla.redhat.com/xmlrpc.cgi',user=u,password=p)
You can get authentication cookies by calling the login() method. These
cookies will be stored in a MozillaCookieJar-style file specified by the
'cookiefile' attribute (which defaults to ~/.bugzillacookies). Once you
get cookies this way, you will be considered logged in until the cookie
expires.
You may also specify 'user' and 'password' in a bugzillarc file, either
/etc/bugzillarc or ~/.bugzillarc. The latter will override the former.
The format works like this:
[bugzilla.yoursite.com]
user = username
password = password
You can also use the [DEFAULT] section to set defaults that apply to
any site without a specific section of its own.
Be sure to set appropriate permissions on bugzillarc if you choose to
store your password in it!
This is an abstract class; it must be implemented by a concrete subclass
which actually connects the methods provided here to the appropriate
methods on the bugzilla instance.
:kwarg url: base url for the bugzilla instance
:kwarg user: usename to connect with
:kwarg password: password for the connecting user
:kwarg cookiefile: Location to save the session cookies so you don't have
to keep giving the library your username and password. This defaults
to ~/.bugzillacookies. If set to None, the library won't save the
cookies persistently.
s ~/.bugzillacookiesc C s | p d | _ | p d | _ d | _ | o
d | _ n
t | _ t | _ | | _ t | _ t | _
| i | o | i | n d S( Nt (
t usert passwordt urlR t _cookiefilet Truet _persist_cookiet
cookiefilet
user_agentt Falset logged_int init_private_datat connect( t selfR R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt __init__Z s
c C s
| ` d S( N( R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt __del__q s c C s[ d | _ d | _ d | _ d | _ d | _ d | _ d | _ t | _ t | _
d S( s< initialize private variables used by this bugzilla instance.N( R t _proxyt
_transportt _openert
_querydatat _querydefaultst _productst
_bugfieldsR t _componentst _components_details( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR t s c C s | i S( s` cookiefile is the file that bugzilla session cookies are loaded
and saved from.
( R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getcookiefile s c C sr | | i j o d S| ` | | _ t i | i } | i p{ t | _ t i \ } | _ t i | y | i
| i WqVt j
o) } t i
d | i t | f qVXn t | _ t i i | i o | i | i ni t i d } y | i
| i Wn5 t j
o) } t i d | i t | f n Xt i | | | _ | i | i _ d S( Ns. Couldn't initialize temporary cookiefile%s: %si? s% Couldn't initialize cookiefile %s: %s( R R t cookielibt MozillaCookieJarR R t tempfilet mkstempt ost closet savet Exceptiont logt warnt strR t patht existst loadt umaskt errort
_cookiejart filename( R R t cjt fht et old_umask( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _setcookiefile s4
c C s4 | i p t i | i n d | _ d | _ d S( N( R R/ t removeR R R R; ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _delcookiefile s
c C s* | p t i i d } n | | _ d S( s Deprecated: Set self.cookiefile instead. It's a property that will
take care of these details.
Read the given (Mozilla-style) cookie file and fill in the
cookiejar, allowing us to use saved credentials to access Bugzilla.
:kwarg cookiefile: Location to save the session cookies so you don't
have to keep giving the library your username and password. This
defaults to ~/.bugzillacookies.
s ~/.bugzillacookiesN( R/ R6 t
expanduserR ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt initcookiefile s s /etc/bugzillarcs
~/.bugzillarcc
C s> d d k } | p
| i } n g } | D] } | t i i | q+ ~ } | i } | i | } | p d Sd } t i d | i xK t
| i d D]1 } | | i j o t i d | | } q q W| p d SxO | i | D]> \ } }
| d
j o% t i d | t
| | |
q q Wd S( s$ Read bugzillarc file(s) into memory.iNR s( Searching for config section matching %sc S s) t t | t | p
t | | S( ( t cmpt len( t at b( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt <lambda> s s Found matching section: %sR R s Setting '%s' from configfile( s users password( t ConfigParsert
configpathR/ R6 RD t SafeConfigParsert readR3 t debugR t sortedt sectionst itemst setattr( R RL RK t _[1]t pt cR t sectiont st kt v( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
readconfig s,
-
c C s | i d o t | _ n
t | _ | i | i _ | i | i _ t i | | i | _ t
i | i } t
i | | _
d | i f g | i
_ | | _ | i | i o% | i o t i d | i n d S( sR Connect to the bugzilla instance with the given url.
This will also read any available config files (see readconfig()),
which may set 'user' and 'password'.
If 'user' and 'password' are both set, we'll run login(). Otherwise
you'll have to login() yourself before some methods will work.
t httpss
User-agents) user and password present - doing login()N( t
startswitht SafeCookieTransportR" t CookieTransportR R; t cookiejart xmlrpclibt ServerProxyR! t urllib2t HTTPCookieProcessort build_openerR# t
addheadersR R[ R R R3 t infot login( R R t handler( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s
c C s | i d S( s, Disconnect from the given bugzilla instance.N( R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
disconnect s c C s
t d S( s" IMPLEMENT ME: backend login methodN( t NotImplementedError( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _login s c C s | o
| | _ n | o
| | _ n | i p
t d n | i p
t d n y; | i | i | i } t | _ t i d d | _ Wn t i j
o } t
} n X| S( s Attempt to log in using the given username and password. Subsequent
method calls will use this username and password. Returns False if
login fails, otherwise returns some kind of login info - typically
either a numeric userid, or a dict of user info. It also sets the
logged_in attribute to True, if successful.
If user is not set, the value of Bugzilla.user will be used. If *that*
is not set, ValueError will be raised.
This method will be called implicitly at the end of connect() if user
and password are both set. So under most circumstances you won't need
to call this yourself.
s missing usernames missing passwords0 login successful - dropping password from memoryR ( R R t
ValueErrorRl R R R3 Rg Ra t FaultR ( R R R R t f( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRh s
c C s
t d S( s" IMPLEMENT ME: backend login methodN( Rk ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _logout% s c C s3 | i | i d | _ d | _ t | _ d S( sh Log out of bugzilla. Drops server connection and user info, and
destroys authentication cookies.R N( Rp Rj R R R R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt logout) s
c C s
t d S( s* IMPLEMENT ME: Get bugfields from Bugzilla.N( Rk ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
_getbugfields4 s c C s
t d S( s* IMPLEMENT ME: Get queryinfo from Bugzilla.N( Rk ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
_getqueryinfo7 s c C sn | p | i oU y | i | _ Wqg t i j
o, } | i d j o
g | _ qc | qg Xn | i S( s Calls getBugFields, which returns a list of fields in each bug
for this bugzilla instance. This can be used to set the list of attrs
on the Bug object.t Client( R' Rr Ra Rn t faultCode( R t
force_refreshRo ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getbugfields; s
t fgetc C s
| i S( ( Rw ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ K s t fdelc C s t | d d S( R' N( RS R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ L s c C sH | p | i o | i o | i \ | _ | _ n | i | i f S( s Calls getQueryInfo, which returns a (quite large!) structure that
contains all of the query data and query defaults for the bugzilla
instance. Since this is a weighty call - takes a good 5-10sec on
bugzilla.redhat.com - we load the info in this private method and the
user instead plays with the querydata and querydefaults attributes of
the bugzilla object.( R$ R% Rs ( R Rv ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getqueryinfoN s c C s | i d S( i ( Rz ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ ] s c C s t | d d S( R$ N( RS R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ ^ s c C s | i d S( i ( Rz ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ _ s c C s t | d d S( R% N( RS R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ ` s c C s
t d S( s- IMPLEMENT ME: Get product info from Bugzilla.N( Rk ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getproductsd s c C s, | p | i o | i | _ n | i S( sn Get product data: names, descriptions, etc.
The data varies between Bugzilla versions but the basic format is a
list of dicts, where the dicts will have at least the following keys:
{'id':1,'name':"Some Product",'description':"This is a product"}
Any method that requires a 'product' can be given either the
id or the name.( R& R{ ( R Rv ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getproductsh s c C s
| i S( ( R| ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ u s c C s t | d d S( R& N( RS R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRJ v s c C s2 x+ | i D] } | d | j o | d Sq
Wd S( s3 Convert a product ID (int) to a product name (str).t idt nameN( t products( R t productidRU ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _product_id_to_namew s
c C s2 x+ | i D] } | d | j o | d Sq
Wd S( s3 Convert a product name (str) to a product ID (int).R~ R} N( R ( R t productRU ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _product_name_to_id} s
c C s
t d S( s1 IMPLEMENT ME: get component details for a productN( Rk ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getcomponentsdetails s c C s
t d S( s. IMPLEMENT ME: Get component dict for a productN( Rk ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getcomponents s c C s
t d S( s IMPLEMENT ME: Add a componentN( Rk ( R t data( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
_addcomponent s c C s
t d S( s IMPLEMENT ME: Edit a componentN( Rk ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _editcomponent s c C s< | p | | i j o | i | | i | <n | i | S( s? Return a dict of components:descriptions for the given product.( R( R ( R R Rv ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
getcomponents s c C sw | p | | i j oU | i | } t } x) | D]! } | d } | d =| | | <q6 W| | i | <n | i | S( s Returns a dict of dicts, containing detailed component information
for the given product. The keys of the dict are component names. For
each component, the value is a dict with the following keys:
description, initialowner, initialqacontact, initialcclistt component( R) R R ( R R Rv t clistt cdictt itemR~ ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getcomponentsdetails s
c C s | i | | } | | S( s Get details for a single component. Returns a dict with the
following keys:
description, initialowner, initialqacontact, initialcclist( R ( R R R Rv t d( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getcomponentdetails s c C s | i | d S( sm A method to create a component in Bugzilla. Takes a dict, with the
following elements:
product: The product to create the component in
component: The name of the component to create
initialowner: The bugzilla login (email address) of the initial owner
of the component
initialqacontact: The bugzilla login of the initial QA contact
initialcclist: The initial list of users to be CC'ed on new bugs for
the component.
desription: A one sentence summary of the component
product, component, description and initalowner are mandatory.
N( R ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt addcomponent s c C s | i | d S( s A method to edit a component in Bugzilla. Takes a dict, with
mandatory elements of product. component, and initialowner.
All other elements are optional and use the same names as the
addcomponent() method.N( R ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
editcomponent s c C s
t d S( sA IMPLEMENT ME: Return a dict of full bug info for the given bug idN( Rk ( R R} ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getbug s c C s
t d S( sY IMPLEMENT ME: Return a list of full bug dicts, one for each of the
given bug idsN( Rk ( R t idlist( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getbugs s c C s
t d S( sQ IMPLEMENT ME: Return a short dict of simple bug info for the given
bug idN( Rk ( R R} ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
_getbugsimple s c C s
t d S( sY IMPLEMENT ME: Return a list of short bug dicts, one for each of the
given bug idsN( Rk ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getbugssimple s c C s
t d S( s@ IMPLEMENT ME: Query bugzilla and return a list of matching bugs.N( Rk ( R t query( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _query s c C s3 t i d t | t d | d | i | S( sP Return a Bug object with the full complement of bug data
already loaded.s
getbug(%s)R R ( R3 RO R5 t _BugR ( R R} ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getbug s c C s t d | d | i | S( s< Return a Bug object given bug id, populated with simple infoR R ( R R ( R R} ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getbugsimple s c C sE g } | i | D]* } | | o t d | d | p d q ~ S( s Return a list of Bug objects with the full complement of bug data
already loaded. If there's a problem getting the data for a given id,
the corresponding item in the returned list will be None.R R N( R R R ( R R RT RI ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getbugs s c C sE g } | i | D]* } | | o t d | d | p d q ~ S( s Return a list of Bug objects for the given bug ids, populated with
simple info. As with getbugs(), if there's a problem getting the data
for a given bug ID, the corresponding item in the returned list will
be None.R R N( R R R ( R R RT RI ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
getbugssimple s c C sA | i | } g } | d D] } | t d | d | q ~ 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 list of Bug objects.
Also see the _query() method for details about the underlying
implementation.
t bugsR R ( R R ( R R R RT RI ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s R t allwordssubstrc C s6 h | d 6| d 6| d 6| d 6| d 6} | i | S( s Convenience method - query for bugs filed against the given
product, version, and component whose comments match the given string.
matchtype specifies the type of match to be done. matchtype may be
any of the types listed in querydefaults['long_desc_type_list'], e.g.:
['allwordssubstr','anywordssubstr','substring','casesubstring',
'allwords','anywords','regexp','notregexp']
Return value is the same as with query().
R t versionR t long_desct long_desc_type( R ( R R R R t stringt matchtypet q( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt simplequery s c C s
t d S( s/ IMPLEMENT ME: add a comment to the given bug IDN( Rk ( R R} t commentt privatet timestampt worktimet bz_gid( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _addcomment s c C s
t d S( s0 IMPLEMENT ME: Set the status of the given bug IDN( Rk ( R R} t statusR R t
private_in_itt nomail( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
_setstatus s c C s
t d S( s$ IMPLEMENT ME: close the given bug IDN( Rk ( R R} t
resolutiont dupeidt fixedinR t isprivateR R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _closebug s c K s
t d S( s2 IMPLEMENT ME: set the assignee of the given bug IDN( Rk ( R R} R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _setassignee s c C s
t d S( s IMPLEMENT ME: update the deps (blocked/dependson) for the given bug.
blocked, dependson: list of bug ids/aliases
action: 'add' or 'delete'
N( Rk ( R R} t blockedt dependsont action( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _updatedeps s c C s
t d S( s IMPLEMENT ME: Update 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.
Note that using 'overwrite' may result in up to three XMLRPC calls
(fetch list, remove each element, add new elements). Avoid if possible.
N( Rk ( R R} t cclistR R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _updatecc! s
c C s
t d S( s IMPLEMENT ME: 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.N( Rk ( R R} t textt whichR ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _updatewhiteboard, s c C s
t d 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.N( Rk ( R R} t flags( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _updateflags1 s c C sP d } d } | i | } x. | o& | t i | } | i | } q W| S( s Return the contents of the file-like object fh in a form
appropriate for attaching to a bug in bugzilla. This is the default
encoding method, base64.i R ( RN t base64t b64encode( R R> t chunksizeR t chunk( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _attachment_encode: s c K s
t d S( s IMPLEMENT ME: attach a file to the given bug.
attachdata MUST contain the following keys:
data: File data, encoded in the bugzilla-preferred format.
attachfile() will encode it with _attachment_encode().
description: Short description of this attachment.
filename: Filename for the attachment.
The following optional keys may also be added:
comment: An optional comment about this attachment.
isprivate: Set to True if the attachment should be marked private.
ispatch: Set to True if the attachment is a patch.
contenttype: The mime-type of the attached file. Defaults to
application/octet-stream if not set. NOTE that text
files will *not* be viewable in bugzilla unless you
remember to set this to text/plain. So remember that!
Returns (attachment_id,mailresults).
N( Rk ( R R} t
attachdata( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _attachfileK s c K s t | t o t | } n$ t | d o
| } n
t d | | d <d | j o t i i | i | d <n d | j o d | d <n | i | | d <| i
| | \ } } | S( s Attach a file to the given bug ID. Returns the ID of the attachment
or raises xmlrpclib.Fault if something goes wrong.
attachfile may be a filename (which will be opened) or a file-like
object, which must provide a 'read' method. If it's not one of these,
this method will raise a TypeError.
description is the short description of this attachment.
Optional keyword args are as follows:
filename: this will be used as the filename for the attachment.
REQUIRED if attachfile is a file-like object with no
'name' attribute, otherwise the filename or .name
attribute will be used.
comment: An optional comment about this attachment.
isprivate: Set to True if the attachment should be marked private.
ispatch: Set to True if the attachment is a patch.
contenttype: The mime-type of the attached file. Defaults to
application/octet-stream if not set. NOTE that text
files will *not* be viewable in bugzilla unless you
remember to set this to text/plain. So remember that!
RN s/ attachfile must be filename or file-like objectt descriptionR< t contenttypes application/octet-streamR ( R R5 t opent hasattrt TypeErrorR/ R6 t basenameR~ R R ( R R} t
attachfileR t kwargsRo t attachidt mailresults( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR ^ s
c C s' | i i d d } | d | } | S( s, Returns the URI for the given attachment ID.s
xmlrpc.cgis attachment.cgis ?id=%i( R t replace( R R t att_uri( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _attachment_uri s c C s | i | } t i t i | i } | i | } | i d i d } g } | D]' } | i i d o | | qZ qZ ~ \ } | i d \ } }
|
i d | _
| S( sd Get the contents of the attachment with the given attachment ID.
Returns a file-like object.s content-dispositiont ;s filename=t =t "( R Rc Re Rd R; R t headerst splitt stripR] R~ ( R R R t openert attt dispRT t it
filename_parmt dummyR< ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt openattachment s >R R R t
short_descR t rep_platformt bug_severityt op_syst bug_file_loct summaryR t platformt severityR t
bug_statusc K s
t d S( s IMPLEMENT ME: Raw xmlrpc call for createBug()
Doesn't bother guessing defaults or checking argument validity.
Returns bug_idN( Rk ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
_createbug s c K s8 xX | i D]M \ } } | | i j o1 | | j o$ | | j o | i | | | <q
q
WxV | i D]K } | | j p | | o, | d j o d | | <q t d | qe qe W| o^ | d | i d j o t d | d n | d | i d j o t d | d qn | i | } t | d
| S( s
Create a bug with the given info. Returns a new Bug object.
data should be given as keyword args - remember that you can also
populate a dict and call createbug(**dict) to fill in keyword args.
The arguments are as follows. Note that some are required, some are
defaulted, and some are completely optional.
The Bugzilla 3.2 docs say the following:
"Clients that want to be able to interact uniformly with multiple
Bugzillas should always set both the params marked Required and those
marked Defaulted, because some Bugzillas may not have defaults set for
Defaulted parameters, and then this method will throw an error if you
don't specify them."
REQUIRED:
product: Name of Bugzilla product.
Ex: Red Hat Enterprise Linux
component: Name of component in Bugzilla product.
Ex: anaconda
version: Version in the list for the Bugzilla product.
Ex: 4.5
See querydata['product'][<product>]['versions'] for values.
summary: One line summary describing the bug report.
DEFAULTED:
platform: Hardware type where this bug was experienced.
Ex: i386
See querydefaults['rep_platform_list'] for accepted values.
severity: Bug severity.
Ex: medium
See querydefaults['bug_severity_list'] for accepted values.
priority: Bug priority.
Ex: medium
See querydefaults['priority_list'] for accepted values.
op_sys: Operating system bug occurs on.
Ex: Linux
See querydefaults['op_sys_list'] for accepted values.
description: A detailed description of the bug report.
OPTIONAL:
alias: Give the bug a (string) alias name.
Alias can't be merely numerical.
Alias can't contain spaces or commas.
Alias can't be more than 20 chars long.
Alias has to be unique.
assigned_to: Bugzilla username to assign this bug to.
qa_contact: Bugzilla username of QA contact for this bug.
cc: List of Bugzilla usernames to CC on this bug.
status: Status to place the new bug in. Defaults to NEW.
Important custom fields (used by RH Bugzilla and maybe others):
DEFAULTED:
bug_file_loc: URL pointing to additional information for bug report.
Ex: http://username.fedorapeople.org/logs/crashlog.txt
reporter: Bugzilla username to use as reporter.
OPTIONAL:
blocked: List of bug ids this report blocks.
dependson: List of bug ids this report depends on.
R s http://s% required field missing or empty: '%s'R t op_sys_lists invalid value for op_sys: %sR t rep_platform_lists" invalid value for rep_platform: %sR ( t
field_aliasest createbug_requiredt popR t
querydefaultsRm R R ( R t
check_argsR t newfieldt oldfieldR R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt createbug s$ ?
c C s
t d S( s) IMPLEMEMT ME: Get a list of Bugzilla userN( Rk ( R t idst namest match( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _getusers s c C s
t d S( s$ IMPLEMEMT ME: Create a Bugzilla userN( Rk ( R t emailR~ R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _createuser s c C s
t d S( s. IMPLEMEMT ME: Update Bugzilla user permissionsN( Rk ( R R R t group( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _updateperms s c C s
t d S( s[ IMPLEMENT ME: Add a bugzilla user
Deprecated. User _createuser() instead
N( Rk ( R R R~ ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _adduser s c
C sY | i d | g d d } t | d | d d | d d | d d | d d | d S(
s Return a bugzilla User for the given username
:arg username: The username used in bugzilla.
:raises xmlrpclib.Fault: Code 51 if the username does not exist
:returns: User record for the username
R t usersi t useridR} t real_nameR R~ t can_login( R t _User( R t usernamet rawuser( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getuser# s c C sg g } | i d | d D]E } | t | d | d d | d d | d d | d d | d q ~ S( s Return a list of Users from bugzilla.
:userlist: List of usernames to lookup
:returns: List of User records
R R R R} R R R~ R ( R R ( R t userlistRT R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt getusers/ s c C sg g } | i d | d D]E } | t | d | d d | d d | d d | d d | d q ~ S( s Return a bugzilla User for the given list of patterns
:arg pattern: List of patterns to match against.
:returns: List of User records
R R R R} R R R~ R ( R R ( R t patternRT R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt searchusers: s c C s" | i | | | } | i | S( s Return a bugzilla User for the given username
:arg email: The email address to use in bugzilla
:kwarg name: Real name to associate with the account
:kwarg password: Password to set for the bugzilla account
:raises xmlrpclib.Fault: Code 501 if the username already exists
Code 500 if the email address isn't valid
Code 502 if the password is too short
Code 503 if the password is too long
:return: User record for the username
( R R ( R R R~ R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
createuserE s c C s | i | | | d S( sM A method to update the permissions (group membership) of a bugzilla
user. Deprecated. Use User.updateperms(action, group) instead.
:arg user: The e-mail address of the user to be acted upon
:arg action: either add or rem
:arg groups: list of groups to be added to (i.e. ['fedora_contrib'])
N( R ( R R R t groups( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt updatepermsT s c C s | i | | d S( s Deprecated: Use createuser() instead.
A method to create a user in Bugzilla. Takes the following:
user: The email address of the user to create
name: The full name of the user to create
N( R ( R R R~ ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt adduser^ s N( s products components versions
short_descs comments rep_platformR s op_syss bug_file_loc( s summarys
short_desc( s descriptions comment( s platforms rep_platform( R R ( s statuss
bug_status(T R R R R R/ R6 RD R R R R* RA RC t propertyR RE RL R[ R Rj Rl Rh Rp Rq Rr Rs R Rw t bugfieldsRz t querydataR R{ R| R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R R
R R
R R ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR 8 s ! # !
$ b
t CookieResponsec B s e Z d Z d Z d Z RS( s Fake HTTPResponse object that we can fill with headers we got elsewhere.
We can then pass it to CookieJar.extract_cookies() to make it pull out the
cookies from the set of headers we have.c C s
| | _ d S( N( R ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR l s c C s | i S( N( R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRg o s ( R R R R Rg ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR h s R_ c B s/ e Z d Z d Z d Z d Z d d Z RS( s8 A subclass of xmlrpclib.Transport that supports cookies.t httpc C s% | i d j o t i d t i | _ n | i o t i d t i d | i | i i | t i d | i t } xX | i D]J \ } } | i d o. t i d | | f | i
| | g q q Wx5 | D] \ } } | i | | q Wn t i d d S( Ns, send_cookies(): creating in-memory cookiejars( send_cookies(): using existing cookiejars$ cookie_request headers currently: %ss cookie_request headers now: %st Cookies sending cookie: %s=%ss1 send_cookies(): cookiejar empty. Nothing to send.( R` R R3 RO R+ t CookieJart header_itemst add_cookie_headert listR] R
t putheader( R t
connectiont cookie_requestt
cookielistt hRZ ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt send_cookiesx s$
i c C s | i | } | o | i d n d | i | | f } t i d | t i | } | i | | | | i | | | i | | | i
| | i | | | i \ } } }
t
|
} | i i | | t i d | i i t | i d oY y | i i | i i Wqdt j
o, } t i d | i i t | f qdXn | d j o t i | | | | |
n | | _ y | i i }
Wn t j
o
d }
n X| i | i |
S( Ni s %s://%s%ss request_url is %ss cookiejar now contains: %sR1 s Couldn't write cookiefile %s: %si ( t make_connectiont set_debuglevelt schemeR3 RO Rc t Requestt send_requestt send_hostR t send_user_agentt send_contentt getreplyR R` t extract_cookiest _cookiesR R1 R< R2 R: R5 Ra t
ProtocolErrort verboset _connt sockt AttributeErrorR t _parse_responset getfile( R t hostRi t request_bodyR- R t request_urlR t errcodet errmsgR t cookie_responseR? R/ ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt request s@
#
N( R R R R R` R# R R9 ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR_ r s
R^ c B s e Z d Z d Z e i Z RS( s- SafeTransport subclass that supports cookies.R\ ( R R R R# R_ R9 ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR^ s R c B s e Z d Z d d e d Z e d Z e d Z e d Z d Z
d Z e e
e Z d Z
d Z RS(
sG Container object for a bugzilla User.
:arg bugzilla: Bugzilla instance that this User belongs to.
:arg name: name that references a user
:kwarg userid: id in bugzilla for a user
:kwarg real_name: User's real name
:kwarg email: User's email address
:kwarg can_login: If set True, the user can login
c C sC | | _ | | _ | | _ | | _ | | _ | | _ t | _ d S( N( R t _User__namet
_User__useridR t _User__emailt _User__can_loginR t _name_dirty( R R R~ R R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s c C s | i S( N( R; ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s c C s | i S( N( R< ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s c C s | i S( N( R= ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s c C s | i S( N( R: ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _name s c C s t | _ | | _ d S( N( R R> R: ( R t value( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt _set_name s c C sG t | _ | i i d | i d h | i d 6| i d 6| i d 6 d S( s Update Bugzilla with these values.
:raises xmlrpclib.Fault: Code 304 if you aren't allowed to edit
the user
R t updateR~ R R N( R t _name__dirtyR t _updateR R~ R R ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRB s "c C s7 | i o t d n | i i | i | | d S( s A method to update the permissions (group membership) of a bugzilla
user.
:arg action: either add or rem
:arg groups: list of groups to be added to (i.e. ['fedora_contrib'])
s; name has been changed. run update() before updating perms.N( R> R R R R~ ( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s
N( R R R R R R R R R R R? RA R~ RB R ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s
R c B s e Z d Z d Z d Z d Z d Z d Z d Z d e e e d Z
d d d d d Z e d d d d
Z d d d e e e d Z
d
Z d Z d d Z d d Z d d Z d d Z d d Z d d Z d d Z d d Z d d Z RS( so A container object for a bug report. Requires a Bugzilla instance -
every Bug is on a Bugzilla, obviously.
Optional keyword args:
dict=DICT - populate attributes with the result of a getBug() call
bug_id=ID - if dict does not contain bug_id, this is required before
you can read any attributes or make modifications to this
bug.
autorefresh - automatically refresh the data in this bug after calling
a method that modifies the bug. Defaults to True. You can
call refresh() to do this manually.
c K s | | _ t | _ d | j o> | d o3 t i d | d i | i i | d n d | j o- t i d | d t | d | d n d | j o | d | _ n t | d p- t | d o | i
| _ q t d n | i
i d d | i | _
d S(
NR s Bug(%s)R s Bug(%i)t autorefreshR} s Bug object needs a bug_ids
xmlrpc.cgis show_bug.cgi?id=%i( R R RE R3 RO t keyst __dict__RB RS R R} R R R R ( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s
c C s d | i j o
| i } n^ d | i j o
| i } nA d | i j o
| i } n$ t i d d } t i | i d | i j o0 d | i j o | i i | i | _
q n d | i | i | i
| f S( s1 Return a simple string representation of this bugt short_short_descR R s Weird; this bug has no summary?s [ERROR: SUMMARY MISSING]t assigned_tot assigned_to_ids #%-6s %-10s - %s - %s(
RG RH R R R3 R4 RO R t
_getuserforidRJ RI R R ( R t desc( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt __str__3 s
c C s d | i | i i t | f S( Ns <Bug #%i on %s at %#x>( R R R R} ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt __repr__H s c C s| d | i j o[ | i i o$ | | i i j o t d | n | i | | i j o | i | Sn t d | d S( NR s" field %s not in bugzilla.bugfieldss Bug object has no attribute '%s'( RG R R R0 t refresh( R R~ ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt __getattr__L s
c C s) | i i | i } | i i | d S( s! Refresh all the data in this Bug.N( R R R RG RB ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyRO W s c C s | i d S( s An alias for refresh()N( RO ( R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt reload\ s R c C s& | i i | i | | | | | d S( s Update the status for this bug report.
Valid values for status are listed in querydefaults['bug_status_list']
Commonly-used values are ASSIGNED, MODIFIED, and NEEDINFO.
To change bugs to CLOSED, use .close() instead.
See Bugzilla._setstatus() for details.N( R R R ( R R R R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt setstatus` s c
C sS | p | p | p
t d n | i i | i d | d | d | d | } | S( s Set any of the assigned_to, reporter, or qa_contact fields to a new
bugzilla account, with an optional comment, e.g.
setassignee(reporter='sadguy@brokencomputer.org',
assigned_to='wwoods@redhat.com')
setassignee(qa_contact='wwoods@redhat.com',comment='wwoods QA ftw')
You must set at least one of the three assignee fields, or this method
will throw a ValueError.
Returns [bug_id, mailresults].s8 You must set one of assigned_to, reporter, or qa_contactRI t reportert
qa_contactR ( Rm R R R ( R RI RS RT R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt setassigneei s
c C s& | i i | i | | | | | d S( sP Add the given comment to this bug. Set private to True to mark this
comment as private. You can also set a timestamp for the comment, in
"YYYY-MM-DD HH:MM:SS" form. Worktime is undocumented upstream.
If bz_gid is set, and the entire bug is not already private to that
group, this comment will be private.N( R R R ( R R R R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
addcommentz s i c C s, | i i | i | | | | | | | d S( sA Close this bug.
Valid values for resolution are in bz.querydefaults['resolution_list']
For bugzilla.redhat.com that's:
['NOTABUG','WONTFIX','DEFERRED','WORKSFORME','CURRENTRELEASE',
'RAWHIDE','ERRATA','DUPLICATE','UPSTREAM','NEXTRELEASE','CANTFIX',
'INSUFFICIENT_DATA']
If using DUPLICATE, you need to set dupeid to the ID of the other bug.
If using WORKSFORME/CURRENTRELEASE/RAWHIDE/ERRATA/UPSTREAM/NEXTRELEASE
you can (and should) set 'new_fixed_in' to a string representing the
version that fixes the bug.
You can optionally add a comment while closing the bug. Set 'isprivate'
to True if you want that comment to be private.
If you want to suppress sending out mail for this bug closing, set
nomail=True.
N( R R R ( R R R R R R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR0 s c C s | i i | i | d S( s Updates the bugzilla flags.
The flags values are a hash of {'flagname': 'value'} pairs.
Each product seems to have different flags available, so this can be
error-prone unless the error code is understood.
N( R R R ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt updateflags s c C s | i i | i | | | d S( s Actually does the updateWhiteboard call to perform the given action
(append,prepend,overwrite) with the given text on the given whiteboard
for the given bug.N( R R R ( R R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
_dowhiteboard s R c C s t | d | S( s Get the current value of the whiteboard specified by 'which'.
Known whiteboard names: 'status','internal','devel','qa'.
Defaults to the 'status' whiteboard.s
%s_whiteboard( t getattr( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
getwhiteboard s c C s | i | | d d S( su Append the given text (with a space before it) to the given
whiteboard. Defaults to using status_whiteboard.R
N( RX ( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt appendwhiteboard s c C s | i | | d d S( sx Prepend the given text (with a space following it) to the given
whiteboard. Defaults to using status_whiteboard.t prependN( RX ( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt prependwhiteboard s c C s | i | | d d S( sq Overwrites the contents of the given whiteboard with the given text.
Defaults to using status_whiteboard.t overwriteN( RX ( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt
setwhiteboard s c C s> | i | } | o | i | | n | i | | d S( s$ Adds the given tag to the given bug.N( RZ R[ R_ ( R t tagR t
whiteboard( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt addtag s c C s | i | i S( sQ Get a list of tags (basically just whitespace-split the given
whiteboard)( RZ R ( R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt gettags s c C s9 | i | } | i | | i d i | | d S( s) Removes the given tag from the given bug.t N( Rc RB R_ t join( R R` R t tags( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt deltag s
c C s | i i | i | d | d S( s Adds the given email addresses to the CC list for this bug.
cclist: list of email addresses (strings)
comment: optional comment to add to the bugt addN( R R R ( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt addcc s c C s | i i | i | d | d S( s@ Removes the given email addresses from the CC list for this bug.t deleteN( R R R ( R R R ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt deletecc s ( R R R R RM RN RP RO RQ R RR RU RV R0 RW RX RZ R[ R] R_ Rb Rc Rg Ri Rk ( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyR s, ( Ra Rc R+ t ImportErrort ClientCookieR/ R R- t loggingt getLoggerR3 R t __version__R R2 R R R R t objectR R t TransportR_ t
SafeTransportR^ R R t Bug( ( ( s1 /usr/lib/python2.6/site-packages/bugzilla/base.pyt <module> s4 3
M E