ó ýGpNc@s›dZddlZddlZddlZddlZddlmZddlmZ d„Z dfd„ƒYZ e e d„Z d efd „ƒYZdS( s"Abstract crash database interface.iÿÿÿÿN(t Exception(timplcCs,t|ƒtdƒkr(|jddƒS|S(s.Convert str to an unicode if it isn't already.tsutf-8tignore(ttypetdecode(tstr((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt_ust CrashDatabasecBs.eZd„Zd„Zd„Zdd„Zd„Zd„Zd„Z d„Z e d„Z d „Z dd „Zd „Zd „Ze ddd „Zdd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zd„Zdd„Z d„Z!RS( cCs(||_||_||_d|_dS(s‹Initialize crash database connection. You need to specify an implementation specific file with the authentication credentials for retracing access for download() and update(). For upload() and get_comment_url() you can use None. options is a dictionary with additional settings from crashdb.conf; see get_crashdb() for details. N(t auth_filetoptionstbugpattern_baseurltNonet duplicate_db(tselfR R R ((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt__init__s   cCs|jS(sµReturn the base URL for bug patterns. See apport.report.Report.search_bug_patterns() for details. If this function returns None, bug patterns are disabled. (R (R((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytget_bugpattern_baseurl(scCsùddl}|jdks$td‚tjj|ƒ pX|dkpXtjj|ƒdk}|j|ddƒ|_|r¥|jj ƒ}|j d ƒ|jj ƒn|jj ƒ}|j d ƒ|j ƒ}|d gkrõt d t|ƒƒ‚ndS(sˆInitialize duplicate database. path specifies an SQLite database. It will be created if it does not exist yet. iÿÿÿÿNtqmarks/this module assumes qmark dbapi parameter styles:memory:ittimeouti sÄCREATE TABLE crashes ( signature VARCHAR(255) NOT NULL, crash_id INTEGER NOT NULL, fixed_version VARCHAR(50), last_change TIMESTAMP)sPRAGMA integrity_checktoksCorrupt duplicate db:(sok(tsqlite3t paramstyletAssertionErrortostpathtexiststgetsizetconnectR tcursortexecutetcommittfetchallt SystemErrorR(RRtdbapi2tinittcurtresult((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytinit_duplicate_db5s    c Cs|jstd‚|s*|j|ƒ}n|j||ƒd|krS|d}n |jƒ}|sid S|j||ƒ}d„}|j|d„ƒ|réx!|D]\}}|j|ƒq¤W|j||ƒ}|j|d„ƒn|s.|jj ƒ}|j dt |ƒ|d fƒ|jj ƒd Sy|dj ƒd} Wnttfk red } nXx|D]F\}} | sŸ| sŸtj| | ƒd krm|j||ƒPqmqmW|j||ƒ|jj ƒ}|j dt |ƒ|d fƒ|jj ƒd S|| fS( s)Check whether a crash is already known. If the crash is new, it will be added to the duplicate database and the function returns None. If the crash is already known, the function returns a pair (crash_id, fixed_version), where fixed_version might be None if the crash is not fixed in the latest version yet. Depending on whether the version in report is smaller than/equal to the fixed version or larger, this calls close_duplicate() or mark_regression(). If the report does not have a valid crash signature, this function does nothing and just returns None. By default, the report gets download()ed, but for performance reasons it can be explicitly passed to this function if it is already available. s-init_duplicate_db() needs to be called beforetDuplicateSignaturecSs†||krdS|dkr3|dkr,dSdSn|dkrV|dkrOdSdSn|dkrfdS|dkrvdStj||ƒS(NiRiÿÿÿÿi(R t packagingtcompare_versions(txty((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytcmpws       cSs|dS(Ni((tk((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytŠscSs|dS(Ni((R,((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyR-‘ss7INSERT INTO crashes VALUES (?, ?, ?, CURRENT_TIMESTAMP)tPackageiiN(R Rtdownloadt_mark_dup_checkedtcrash_signatureR t_duplicate_search_signaturetsortt_duplicate_db_sync_statusRRRRtsplittKeyErrort IndexErrorR'R(tclose_duplicatetmark_regression( RtidtreporttsigtexistingR+tex_idt_R#treport_package_versiontex_ver((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytcheck_duplicateUsL       cCs_|jstd‚|jjƒ}|jd||fƒ}|jdksNt‚|jjƒdS(s²Mark given crash ID as fixed in the duplicate database. version specifies the package version the crash was fixed in (None for 'still unfixed'). s-init_duplicate_db() needs to be called beforesXUPDATE crashes SET fixed_version = ?, last_change = CURRENT_TIMESTAMP WHERE crash_id = ?iN(R RRRtrowcountR(RR:tversionR#tn((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytduplicate_db_fixed¶s  cCsE|jstd‚|jjƒ}|jd|gƒ|jjƒdS(sƒRemove crash from the duplicate database. This happens when a report got rejected or manually duplicated. s-init_duplicate_db() needs to be called befores&DELETE FROM crashes WHERE crash_id = ?N(R RRRR(RR:R#((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytduplicate_db_removeÄscCsH|jstd‚|jjƒ}|jd||gƒ|jjƒdS(sChange a crash ID.s-init_duplicate_db() needs to be called beforesSUPDATE crashes SET crash_id = ?, last_change = CURRENT_TIMESTAMP WHERE crash_id = ?N(R RRRR(Rtold_idtnew_idR#((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytduplicate_db_change_master_idÏs   cCs5|jjƒ}|jdt|ƒ|gƒ|jƒS(sŸLook up signature in the duplicate db. Return [(id, fixed_version)] tuple list. There might be several matches if a crash has been reintroduced in a later version. id is the bug we are looking to find a duplicate for. The result will never contain id, to avoid marking a bug as a duplicate of itself if a bug is reprocessed more than once. sQSELECT crash_id, fixed_version FROM crashes WHERE signature = ? AND crash_id <> ?(R RRRR(RR<R:R#((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyR2Ùs cCs|jstd‚i}|jjƒ}|jdƒxF|D]>\}}}}|ri|||f||Download the problem report from given ID and return a Report.s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyR/@scCstdƒ‚dS(sqUpdate the given report ID with all data from report. This creates a text comment with the "short" data (see ProblemReport.write_mime()), and creates attachments for all the bulk/binary data. If change_description is True, and the crash db implementation supports it, the short data will be put into the description instead (like in a new bug). comment will be added to the "short" data. If attachment_comment is given, it will be added to the attachment uploads. If key_filter is a list or set, then only those keys will be added. s6this method must be implemented by a concrete subclassN(RU(RR:R;tcommenttchange_descriptiontattachment_commentt key_filter((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytupdateEsRc Cs)|j|||dddddgƒdS(sÎUpdate the given report ID for retracing results. This updates Stacktrace, ThreadStacktrace, StacktraceTop, and StacktraceSource. You can also supply an additional comment. R]t StacktracetThreadStacktracetStacktraceSourcet StacktraceTopN(R^(RR:R;RZ((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt update_tracesXscCstdƒ‚dS(sSet username and password.s6this method must be implemented by a concrete subclassN(RU(Rtusernametpassword((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytset_credentialsascCstdƒ‚dS(s2Get 'DistroRelease: ' from the report ID.s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytget_distro_releasefscCstdƒ‚dS(s§Return set of crash IDs which have not been retraced yet. This should only include crashes which match the current host architecture. s6this method must be implemented by a concrete subclassN(RU(R((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytget_unretracedkscCstdƒ‚dS(sReturn set of crash IDs which need duplicate checking. This is mainly useful for crashes of scripting languages such as Python, since they do not need to be retraced. It should not return bugs that are covered by get_unretraced(). s6this method must be implemented by a concrete subclassN(RU(R((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytget_dup_uncheckedsscCstdƒ‚dS(s`Return an ID set of all crashes which are not yet fixed. The list must not contain bugs which were rejected or duplicate. This function should make sure that the returned list is correct. If there are any errors with connecting to the crash database, it should raise an exception (preferably IOError). s6this method must be implemented by a concrete subclassN(RU(R((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt get_unfixed|s cCstdƒ‚dS(sReturn the package version that fixes a given crash. Return None if the crash is not yet fixed, or an empty string if the crash is fixed, but it cannot be determined by which version. Return 'invalid' if the crash report got invalidated, such as closed a duplicate or rejected. This function should make sure that the returned result is correct. If there are any errors with connecting to the crash database, it should raise an exception (preferably IOError). s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyRR‡s cCstdƒ‚dS(s5Return list of affected source packages for given ID.s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytget_affected_packages•scCstdƒ‚dS(s3Check whether the user is the reporter of given ID.s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt is_reporteršscCstdƒ‚dS(sBCheck whether the user is eligible to update a report. A user should add additional information to an existing ID if (s)he is the reporter or subscribed, the bug is open, not a duplicate, etc. The exact policy and checks should be done according to the particular implementation. s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt can_updateŸscCstdƒ‚dS(scReturn master ID for a duplicate bug. If the bug is not a duplicate, return None. s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt duplicate_of©scCstdƒ‚dS(stMark a crash id as duplicate of given master ID. If master is None, id gets un-duplicated. s6this method must be implemented by a concrete subclassN(RU(RR:tmaster((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyR8°scCstdƒ‚dS(spMark a crash id as reintroducing an earlier crash which is already marked as fixed (having ID 'master').s6this method must be implemented by a concrete subclassN(RU(RR:Ro((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyR9·scCstdƒ‚dS(sMark crash id as retraced.s6this method must be implemented by a concrete subclassN(RU(RR:((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt mark_retraced½scCstdƒ‚dS(sMark crash id as 'failed to retrace'. If invalid_msg is given, the bug should be closed as invalid with given message, otherwise just marked as a failed retrace. This can be a no-op if you are not interested in this. s6this method must be implemented by a concrete subclassN(RU(RR:t invalid_msg((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pytmark_retrace_failedÂscCstdƒ‚dS(s‹Mark crash id as checked for being a duplicate This is an internal method that should not be called from outside. s6this method must be implemented by a concrete subclassN(RU(RR:R;((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyR0ÌsN("t__name__t __module__RRR%R RBRFRGRJR2tFalseROR4RWRYR/R^RcRfRgRhRiRjRRRkRlRmRnR8R9RpRrR0(((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyRs>  a    (             c Cs{|stjjddƒ}ni}t||ƒ|d}tjj|ƒrîxžtj|ƒD]Š}tjj||ƒ}tjj|ƒr]|j dƒr]yt||dƒWqçt k rã}t j j d|t|ƒfƒqçXq]q]Wn|s|d}n|d|}|jdƒ} | sB|d|djdƒ} ntd |d tƒtƒd gƒ} | j|| |ƒS( swReturn a CrashDatabase object for the given crash db name. This reads the configuration file 'conf'. If name is None, it defaults to the 'default' value in conf. If conf is None, it defaults to the environment variable APPORT_CRASHDB_CONF; if that does not exist, the hardcoded default is /etc/apport/crashdb.conf. This Python syntax file needs to specify: - A string variable 'default', giving a default value for 'name' if that is None. - A dictionary 'databases' which maps names to crash db configuration dictionaries. These need to have at least the keys 'impl' (Python module in apport.crashdb_impl which contains a concrete 'CrashDatabase' class implementation for that crash db type) and 'bug_pattern_url', which specifies an URL for bug patterns (or None if those are not used for that crash db). tAPPORT_CRASHDB_CONFs/etc/apport/crashdb.confs.ds.conft databasessInvalid file %s: %s tdefaulttbug_pattern_urlsapport.crashdb_impl.RR(RtenvirontgettexecfileRtisdirtlistdirtjointisfiletendswithRtsyststderrtwriteRt __import__tglobalstlocalsR( R tnametconftsettingstconfdDirtcftcfpathtetdbRytm((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyt get_crashdb×s,  !  &tNeedsCredentialscBseZdZRS(s8This may be raised when unable to log in to the crashdb.(RsRtt__doc__(((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyR’ s(R“Rtos.pathtdatetimeR‚t exceptionsRtpackaging_implRR'RRR R‘R’(((s2/usr/lib/python2.7/dist-packages/apport/crashdb.pyts 0 ÿÀ4