a ]f_F@sdZddlZddlmZddlZddlZddlmZddlZddl Z ddl Z ddl Z ddl m Z ddlmZe eZdZejereejd<ee jed kZd Zd Zd Zd ZddddddddZGdddeZddZ d:ddZ!ddZ"ddZ#d d!Z$d"d#Z%ed$ed%d&Z&e j'j(dkr^e j'd'kr^zdd(l)m*Z*Wne+yTYn 0e*e&d)<d*d+Z,d,d-Z-d.d/Z.d0d1Z/d2d3Z0d4d5Z1d6d7Z2d8d9Z3dS);z Query Debian's Bug Tracking System (BTS). This module provides a layer between Python and Debian's BTS. It provides methods to query the BTS using the BTS' SOAP interface, and the Bugreport class which represents a bugreport from the BTS. N) LooseVersion)datetime) SoapClient)SimpleXMLElementz/etc/ssl/ca-debianZ SSL_CERT_DIRz1.16.2z(https://bugs.debian.org/cgi-bin/soap.cgizDebbugs/SOAP/V1zhttps://bugs.debian.org/i)ZcriticalZgraveZseriousZ importantZnormalminorZwishlistc@sXeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ dS) BugreportaRepresents a bugreport from Debian's Bug Tracking System. A bugreport object provides all attributes provided by the SOAP interface. Most of the attributes are strings, the others are marked. Attributes ---------- bug_num : int The bugnumber severity : str Severity of the bugreport tags : list of strings Tags of the bugreport subject : str The subject/title of the bugreport originator : str Submitter of the bugreport mergedwith : list of ints List of bugnumbers this bug was merged with package : str Package of the bugreport source : str Source package of the bugreport date : datetime Date of bug creation log_modified : datetime Date of update of the bugreport done : boolean Is the bug fixed or not done_by : str or None Name and Email or None archived : bool Is the bug archived or not unarchived : bool Was the bug unarchived or not fixed_versions : list of strings List of versions, can be empty even if bug is fixed found_versions : list of strings List of version numbers where bug was found forwarded : str A URL or email address blocks: list of ints List of bugnumbers this bug blocks blockedby : list of int List of bugnumbers which block this bug pending : str Either 'pending' or 'done' msgid : str Message ID of the bugreport owner : str Who took responsibility for fixing this bug location : str Either 'db-h' or 'archive' affects : list of str List of Packagenames summary : str Arbitrary text cCsd|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ d|_ d|_ d|_ d|_ d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_dSN) originatordatesubjectmsgidpackagetagsdone forwarded mergedwithseverityownerfound_versionsfixed_versionsblocks blockedby unarchivedsummaryaffects log_modifiedlocationarchivedbug_numsourcepending)selfr)5/usr/lib/python3/dist-packages/debianbts/debianbts.py__init__ws0zBugreport.__init__cCs"ddd|jD}|dS)N css|]\}}d||VqdS)z{}: {}N)format).0keyvaluer)r)r* sz$Bugreport.__str__..)join__dict__items)r(sr)r)r*__str__s zBugreport.__str__cCs||kS)aCompare a bugreport with another. The more open and urgent a bug is, the greater the bug is: outstanding > resolved > archived critical > grave > serious > important > normal > minor > wishlist. Openness always beats urgency, eg an archived bug is *always* smaller than an outstanding bug. This sorting is useful for displaying bugreports in a list and sorting them in a useful way.  _get_valuer(otherr)r)r*__lt__szBugreport.__lt__cCs || Sr)__gt__r9r)r)r*__le__szBugreport.__le__cCs||kSrr7r9r)r)r*r<szBugreport.__gt__cCs || Sr)r;r9r)r)r*__ge__szBugreport.__ge__cCs||kSrr7r9r)r)r*__eq__szBugreport.__eq__cCs || Sr)r?r9r)r)r*__ne__szBugreport.__ne__cCs.|jr d}n|jrd}nd}|t|j7}|S)Nr )r$r SEVERITIESr)r(valr)r)r*r8szBugreport._get_valueN) __name__ __module__ __qualname____doc__r+r6r;r=r<r>r?r@r8r)r)r)r*r9s=!rc Gst|ttfs|g}|r,td||t}g}tdt|t D]d}|||t }t d}t d||| d|}|d pgD]}| d} |t| qqF|S)aReturns a list of Bugreport objects. Given a list of bugnumbers this method returns a list of Bugreport objects. Parameters ---------- nrs : int or list of ints The bugnumbers additional : int Deprecated! The remaining positional arguments are treated as bugnumbers. This is deprecated since 2.10.0, please use the `nrs` parameter instead. Returns ------- bugs : list of Bugreport objects zdCalling get_status with bugnumbers as positional arguments is deprecated, please use a list instead.rzZarg0 get_status s-gensym3r ) isinstancelisttupleloggerwarningextend_build_soap_clientrangelen BATCH_SIZEr_build_int_array_elcallchildrenappend _parse_status) ZnrsZ additional soap_clientZbugsiZslice_ method_elreplyZ bug_item_elbug_elr)r)r*rIs      rIc Gs|dur g}t|ttfs |g}|r8td||td|g|R}|d}i}|d}|r|j dkr| p|gD]2}t |d}|d} d d | pgD||<q~n4| pgD]&}| }d d | pgD||<q|S) aGet buglists by usertags. Parameters ---------- email : str tags : list of strings If tags are given the dictionary is limited to the matching tags, if no tags are given all available tags are returned. moretags : str Deprecated! The remaining positional arguments are treated as tags. This is deprecated since 2.10.0, please use the `tags` parameter instead. Returns ------- mapping : dict a mapping of usertag -> buglist NzbCalling get_getusertag with tags as positional arguments is deprecated, please use a list instead. get_usertagrJxsi:typez apachens:Mapr/r0cSsg|] }t|qSr)intr.bugr)r)r* #zget_usertag..cSsg|] }t|qSr)rarcr)r)r*re'rf) rKrLrMrNrOrP_soap_client_call attributesgetr0rWstrZget_name) emailrZmoretagsr]Zmap_elmappingZ type_attrZ usertag_eltagZ buglist_elr)r)r*r_s(   r_cCstd|}|d}g}|D]}i}t|d|d<t|d|d<t|d|d<g|d<tjjtjjd}| |d | d | |d | |d <| |q|S) adGet Buglogs. A buglog is a dictionary with the following mappings: * "header" => string * "body" => string * "attachments" => list * "msg_num" => int * "message" => email.message.Message Parameters ---------- nr : int the bugnumber Returns ------- buglogs : list of dicts get_bug_log soapenc:ArrayheaderbodyZmsg_numZ attachments)policyz message) rgrW_parse_string_elrbrkZ feedparserZBytesFeedParserrrZSMTPZfeedencodecloserX)Znrr]items_elZbuglogsZ buglog_elZbuglogZ mail_parserr)r)r*rn+s$    rncCs(td|}|d}dd|p"gDS)aHReturns the newest bugs. This method can be used to query the BTS for the n newest bugs. Parameters ---------- amount : int the number of desired bugs. E.g. if `amount` is 10 the method will return the 10 latest bugs. Returns ------- bugs : list of int the bugnumbers newest_bugsrocSsg|] }t|qSr)rar.item_elr)r)r*reirfznewest_bugs..)rgrW)Zamountr]rwr)r)r*rxVs rxc Osg}|D]\}}|||gq t|dkrJt|dtrJt|d}|rbtd||td}t |D]<\}}dt |}t|ttfrt |||qr| ||qrt } | d|} | d} dd | pgDS) aGet list of bugs matching certain criteria. The conditions are defined by the keyword arguments. Arguments --------- key_value : str Deprecated! The positional arguments are treated as key-values. This is deprecated since 2.10.0, please use the `kwargs` parameters instead. kwargs : Possible keywords are: * "package": bugs for the given package * "submitter": bugs from the submitter * "maint": bugs belonging to a maintainer * "src": bugs belonging to a source package * "severity": bugs with a certain severity * "status": can be either "done", "forwarded", or "open" * "tag": see http://www.debian.org/Bugs/Developer#tags for available tags * "owner": bugs which are assigned to `owner` * "bugs": takes single int or list of bugnumbers, filters the list according to given criteria * "correspondent": bugs where `correspondent` has sent a mail to * "archive": takes a string: "0" (unarchived), "1" (archived) or "both" (un- and archived). if omitted, only returns un-archived bugs. Returns ------- bugs : list of ints the bugnumbers Examples -------- >>> get_bugs(package='gtk-qt-engine', severity='normal') [12345, 23456] r rz_Calling get_bugs with positional arguments is deprecated, please use keyword arguments instead.zargget_bugsrocSsg|] }t|qSr)raryr)r)r*rerfzget_bugs..)r4rPrSrKrLrMrNrOr enumeraterjrUZmarshallrQrVrW) key_valuekwargsargskvr\arg_nZkvZarg_namerZr]rwr)r)r*r|ls$*     r|cCsxt}dD]}t||t||q tt|d|_tt|d|_ddt|d D|_ t |d|_ |j rt|dnd|_ t |d |_t |d |_t|d |_d dt|d  D|_ddt|d D|_ddt|d D|_dd|dp"gD|_dd|dp@gD|_ddt|d dD}dd|D|_|S)z9Return a bugreport object from a given status xml element) rrrrrrr r#r&r'rrr"cSsg|]}|qSr)r))r.rmr)r)r*rerfz!_parse_status..rrNr$rr%cSsg|] }t|qSr)rar.r[r)r)r*rerfrcSsg|] }t|qSr)rarr)r)r*rerfrcSsg|] }t|qSr)rarr)r)r*rerfrcSsg|] }t|qSr)rjr.elr)r)r*rerfrcSsg|] }t|qSr)rrr)r)r*rerfrcSsg|] }|r|qSr)r))r.Z_fr)r)r*rerfr!,cSsg|] }|qSr))strip)r.ar)r)r*rerf)rsetattrrtrZutcfromtimestampfloatrr"rjsplitr _parse_boolrZdone_byr$rrbr%rrrrWrrr!)r^rdZfieldr!r)r)r*rYs. rYZsoap)r#action namespaceZsoap_ns)r r r )CA_CERTSZcacertcCs |td<dS)zSet proxy for SOAP client. You must use this method after import to set the proxy. Parameters ---------- proxy_arg : str proxyN_soap_client_kwargs)Z proxy_argr)r)r*set_soap_proxys rcCstSrrr)r)r)r*get_soap_client_kwargssrcCstfitS)zFactory method that creates a SoapClient. For thread-safety we create SoapClients on demand instead of using a module-level one. Returns ------- sc : SoapClient instance )rrr)r)r)r*rQs rQcGs0g}t|D]\}}|dt||fq |S)zConvert arguments to be consumed by a SoapClient method Soap client required a list of named arguments: >>> _convert_soap_method_args('a', 1) [('arg0', 'a'), ('arg1', 1)] r{)r}rXrj)r soap_argsrr{r)r)r*_convert_soap_method_argssrcGs:t}t|}tr t|||St|||g|RSdS)z!Wrapper to call SoapClient methodN)rQrPYSIMPLESOAP_1_16_2getattr)Z method_namerrZrr)r)r*rg!s rgcCsb||}|dd|dd|ddt||D] }|dt|}|ddq<|S) zNbuild a soapenc:Array made of ints called `el_name` as a child of `parent`z xmlns:soapencz)http://schemas.xmlsoap.org/soap/encoding/r`rozsoapenc:arrayTypez xsd:int[{:d}]itemzxsd:int)Z add_childZ add_attributer-rSrj)Zel_nameparentZlist_rrrzr)r)r*rU.s  rUcCst|}|dvS)z(parse a boolean value from a xml element)r0)rjr)rr0r)r)r*r<srcCs@t|}|d}|r<|jdkrsr         - 2+K/