You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1494 lines
175 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>briteny: britney.py Source File</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.7 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
<li><a href="namespaces.html"><span>Packages</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li id="current"><a href="files.html"><span>Files</span></a></li>
</ul></div>
<h1>britney.py</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a><a class="code" href="namespacebritney.html">00001</a> <span class="comment">#!/usr/bin/env python2.4</span>
<a name="l00002"></a>00002 <span class="comment"># -*- coding: utf-8 -*-</span>
<a name="l00003"></a>00003
<a name="l00004"></a>00004 <span class="comment"># Copyright (C) 2001-2004 Anthony Towns &lt;ajt@debian.org&gt;</span>
<a name="l00005"></a>00005 <span class="comment"># Andreas Barth &lt;aba@debian.org&gt;</span>
<a name="l00006"></a>00006 <span class="comment"># Fabio Tranchitella &lt;kobold@debian.org&gt;</span>
<a name="l00007"></a>00007
<a name="l00008"></a>00008 <span class="comment"># This program is free software; you can redistribute it and/or modify</span>
<a name="l00009"></a>00009 <span class="comment"># it under the terms of the GNU General Public License as published by</span>
<a name="l00010"></a>00010 <span class="comment"># the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00011"></a>00011 <span class="comment"># (at your option) any later version.</span>
<a name="l00012"></a>00012
<a name="l00013"></a>00013 <span class="comment"># This program is distributed in the hope that it will be useful,</span>
<a name="l00014"></a>00014 <span class="comment"># but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00015"></a>00015 <span class="comment"># MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
<a name="l00016"></a>00016 <span class="comment"># GNU General Public License for more details.</span>
<a name="l00017"></a>00017
<a name="l00018"></a>00018 <span class="stringliteral">"""</span>
<a name="l00019"></a>00019 <span class="stringliteral">= Introdution =</span>
<a name="l00020"></a>00020 <span class="stringliteral"></span>
<a name="l00021"></a>00021 <span class="stringliteral">This is the Debian testing updater script, also known as "Britney".</span>
<a name="l00022"></a>00022 <span class="stringliteral"></span>
<a name="l00023"></a>00023 <span class="stringliteral">Packages are usually installed into the `testing' distribution after</span>
<a name="l00024"></a>00024 <span class="stringliteral">they have undergone some degree of testing in unstable. The goal of</span>
<a name="l00025"></a>00025 <span class="stringliteral">this software is to do this task in a smart way, allowing testing</span>
<a name="l00026"></a>00026 <span class="stringliteral">to be always fully installable and close to being a release candidate.</span>
<a name="l00027"></a>00027 <span class="stringliteral"></span>
<a name="l00028"></a>00028 <span class="stringliteral">Britney source code is splitted in two different but related tasks:</span>
<a name="l00029"></a>00029 <span class="stringliteral">the first one is the generation of the update excuses, while the</span>
<a name="l00030"></a>00030 <span class="stringliteral">second tries to update testing with the valid candidates; first </span>
<a name="l00031"></a>00031 <span class="stringliteral">each package alone, then larger and even larger sets of packages</span>
<a name="l00032"></a>00032 <span class="stringliteral">together. Each try is accepted if testing is not more uninstallable</span>
<a name="l00033"></a>00033 <span class="stringliteral">after the update than before.</span>
<a name="l00034"></a>00034 <span class="stringliteral"></span>
<a name="l00035"></a>00035 <span class="stringliteral">= Data Loading =</span>
<a name="l00036"></a>00036 <span class="stringliteral"></span>
<a name="l00037"></a>00037 <span class="stringliteral">In order to analyze the entire Debian distribution, Britney needs to</span>
<a name="l00038"></a>00038 <span class="stringliteral">load in memory the whole archive: this means more than 10.000 packages</span>
<a name="l00039"></a>00039 <span class="stringliteral">for twelve architectures, as well as the dependency interconnection</span>
<a name="l00040"></a>00040 <span class="stringliteral">between them. For this reason, the memory requirement for running this</span>
<a name="l00041"></a>00041 <span class="stringliteral">software are quite high and at least 1 gigabyte of RAM should be available.</span>
<a name="l00042"></a>00042 <span class="stringliteral"></span>
<a name="l00043"></a>00043 <span class="stringliteral">Britney loads the source packages from the `Sources' file and the binary</span>
<a name="l00044"></a>00044 <span class="stringliteral">packages from the `Packages_${arch}' files, where ${arch} is substituted</span>
<a name="l00045"></a>00045 <span class="stringliteral">with the supported architectures. While loading the data, the software</span>
<a name="l00046"></a>00046 <span class="stringliteral">analyze the dependencies and build a directed weighted graph in memory</span>
<a name="l00047"></a>00047 <span class="stringliteral">with all the interconnections between the packages (see Britney.read_sources</span>
<a name="l00048"></a>00048 <span class="stringliteral">and Britney.read_binaries).</span>
<a name="l00049"></a>00049 <span class="stringliteral"></span>
<a name="l00050"></a>00050 <span class="stringliteral">Other than source and binary packages, Britney loads the following data:</span>
<a name="l00051"></a>00051 <span class="stringliteral"></span>
<a name="l00052"></a>00052 <span class="stringliteral"> * Bugs, which contains the count of release-critical bugs for a given</span>
<a name="l00053"></a>00053 <span class="stringliteral"> version of a source package (see Britney.read_bugs).</span>
<a name="l00054"></a>00054 <span class="stringliteral"></span>
<a name="l00055"></a>00055 <span class="stringliteral"> * Dates, which contains the date of the upload of a given version </span>
<a name="l00056"></a>00056 <span class="stringliteral"> of a source package (see Britney.read_dates).</span>
<a name="l00057"></a>00057 <span class="stringliteral"></span>
<a name="l00058"></a>00058 <span class="stringliteral"> * Urgencies, which contains the urgency of the upload of a given</span>
<a name="l00059"></a>00059 <span class="stringliteral"> version of a source package (see Britney.read_urgencies).</span>
<a name="l00060"></a>00060 <span class="stringliteral"></span>
<a name="l00061"></a>00061 <span class="stringliteral"> * Approvals, which contains the list of approved testing-proposed-updates</span>
<a name="l00062"></a>00062 <span class="stringliteral"> packages (see Britney.read_approvals).</span>
<a name="l00063"></a>00063 <span class="stringliteral"></span>
<a name="l00064"></a>00064 <span class="stringliteral"> * Hints, which contains lists of commands which modify the standard behaviour</span>
<a name="l00065"></a>00065 <span class="stringliteral"> of Britney (see Britney.read_hints).</span>
<a name="l00066"></a>00066 <span class="stringliteral"></span>
<a name="l00067"></a>00067 <span class="stringliteral">For a more detailed explanation about the format of these files, please read</span>
<a name="l00068"></a>00068 <span class="stringliteral">the documentation of the related methods. The exact meaning of them will be</span>
<a name="l00069"></a>00069 <span class="stringliteral">instead explained in the chapter "Excuses Generation".</span>
<a name="l00070"></a>00070 <span class="stringliteral"></span>
<a name="l00071"></a>00071 <span class="stringliteral">= Excuses =</span>
<a name="l00072"></a>00072 <span class="stringliteral"></span>
<a name="l00073"></a>00073 <span class="stringliteral">An excuse is a detailed explanation of why a package can or cannot</span>
<a name="l00074"></a>00074 <span class="stringliteral">be updated in the testing distribution from a newer package in </span>
<a name="l00075"></a>00075 <span class="stringliteral">another distribution (like for example unstable). The main purpose</span>
<a name="l00076"></a>00076 <span class="stringliteral">of the excuses is to be written in an HTML file which will be </span>
<a name="l00077"></a>00077 <span class="stringliteral">published over HTTP. The maintainers will be able to parse it manually</span>
<a name="l00078"></a>00078 <span class="stringliteral">or automatically to find the explanation of why their packages have</span>
<a name="l00079"></a>00079 <span class="stringliteral">been updated or not.</span>
<a name="l00080"></a>00080 <span class="stringliteral"></span>
<a name="l00081"></a>00081 <span class="stringliteral">== Excuses generation ==</span>
<a name="l00082"></a>00082 <span class="stringliteral"></span>
<a name="l00083"></a>00083 <span class="stringliteral">These are the steps (with references to method names) that Britney</span>
<a name="l00084"></a>00084 <span class="stringliteral">does for the generation of the update excuses.</span>
<a name="l00085"></a>00085 <span class="stringliteral"></span>
<a name="l00086"></a>00086 <span class="stringliteral"> * If a source package is available in testing but it is not</span>
<a name="l00087"></a>00087 <span class="stringliteral"> present in unstable and no binary packages in unstable are</span>
<a name="l00088"></a>00088 <span class="stringliteral"> built from it, then it is marked for removal.</span>
<a name="l00089"></a>00089 <span class="stringliteral"></span>
<a name="l00090"></a>00090 <span class="stringliteral"> * Every source package in unstable and testing-proposed-updates,</span>
<a name="l00091"></a>00091 <span class="stringliteral"> if already present in testing, is checked for binary-NMUs, new</span>
<a name="l00092"></a>00092 <span class="stringliteral"> or dropped binary packages in all the supported architectures</span>
<a name="l00093"></a>00093 <span class="stringliteral"> (see Britney.should_upgrade_srcarch). The steps to detect if an</span>
<a name="l00094"></a>00094 <span class="stringliteral"> upgrade is needed are:</span>
<a name="l00095"></a>00095 <span class="stringliteral"></span>
<a name="l00096"></a>00096 <span class="stringliteral"> 1. If there is a `remove' hint for the source package, the package</span>
<a name="l00097"></a>00097 <span class="stringliteral"> is ignored: it will be removed and not updated.</span>
<a name="l00098"></a>00098 <span class="stringliteral"></span>
<a name="l00099"></a>00099 <span class="stringliteral"> 2. For every binary package build from the new source, it checks</span>
<a name="l00100"></a>00100 <span class="stringliteral"> for unsatisfied dependencies, new binary package and updated</span>
<a name="l00101"></a>00101 <span class="stringliteral"> binary package (binNMU) excluding the architecture-independent</span>
<a name="l00102"></a>00102 <span class="stringliteral"> ones and the packages not built from the same source.</span>
<a name="l00103"></a>00103 <span class="stringliteral"></span>
<a name="l00104"></a>00104 <span class="stringliteral"> 3. For every binary package build from the old source, it checks</span>
<a name="l00105"></a>00105 <span class="stringliteral"> if it is still built from the new source; if this is not true</span>
<a name="l00106"></a>00106 <span class="stringliteral"> and the package is not architecture-independent, the script</span>
<a name="l00107"></a>00107 <span class="stringliteral"> removes it from testing.</span>
<a name="l00108"></a>00108 <span class="stringliteral"></span>
<a name="l00109"></a>00109 <span class="stringliteral"> 4. Finally, if there is something worth doing (eg. a new or updated</span>
<a name="l00110"></a>00110 <span class="stringliteral"> binary package) and nothing wrong it marks the source package</span>
<a name="l00111"></a>00111 <span class="stringliteral"> as "Valid candidate", or "Not considered" if there is something</span>
<a name="l00112"></a>00112 <span class="stringliteral"> wrong which prevented the update.</span>
<a name="l00113"></a>00113 <span class="stringliteral"></span>
<a name="l00114"></a>00114 <span class="stringliteral"> * Every source package in unstable and testing-proposed-updates is</span>
<a name="l00115"></a>00115 <span class="stringliteral"> checked for upgrade (see Britney.should_upgrade_src). The steps</span>
<a name="l00116"></a>00116 <span class="stringliteral"> to detect if an upgrade is needed are:</span>
<a name="l00117"></a>00117 <span class="stringliteral"></span>
<a name="l00118"></a>00118 <span class="stringliteral"> 1. If the source package in testing is more recent the new one</span>
<a name="l00119"></a>00119 <span class="stringliteral"> is ignored.</span>
<a name="l00120"></a>00120 <span class="stringliteral"></span>
<a name="l00121"></a>00121 <span class="stringliteral"> 2. If the source package doesn't exist (is fake), which means that</span>
<a name="l00122"></a>00122 <span class="stringliteral"> a binary package refers to it but it is not present in the</span>
<a name="l00123"></a>00123 <span class="stringliteral"> `Sources' file, the new one is ignored.</span>
<a name="l00124"></a>00124 <span class="stringliteral"></span>
<a name="l00125"></a>00125 <span class="stringliteral"> 3. If the package doesn't exist in testing, the urgency of the</span>
<a name="l00126"></a>00126 <span class="stringliteral"> upload is ignored and set to the default (actually `low').</span>
<a name="l00127"></a>00127 <span class="stringliteral"></span>
<a name="l00128"></a>00128 <span class="stringliteral"> 4. If there is a `remove' hint for the source package, the package</span>
<a name="l00129"></a>00129 <span class="stringliteral"> is ignored: it will be removed and not updated.</span>
<a name="l00130"></a>00130 <span class="stringliteral"></span>
<a name="l00131"></a>00131 <span class="stringliteral"> 5. If there is a `block' hint for the source package without an</span>
<a name="l00132"></a>00132 <span class="stringliteral"> `unblock` hint or a `block-all source`, the package is ignored.</span>
<a name="l00133"></a>00133 <span class="stringliteral"></span>
<a name="l00134"></a>00134 <span class="stringliteral"> 7. If the suite is unstable, the update can go ahead only if the</span>
<a name="l00135"></a>00135 <span class="stringliteral"> upload happend more then the minimum days specified by the</span>
<a name="l00136"></a>00136 <span class="stringliteral"> urgency of the upload; if this is not true, the package is</span>
<a name="l00137"></a>00137 <span class="stringliteral"> ignored as `too-young'. Note that the urgency is sticky, meaning</span>
<a name="l00138"></a>00138 <span class="stringliteral"> that the highest urgency uploaded since the previous testing</span>
<a name="l00139"></a>00139 <span class="stringliteral"> transition is taken into account.</span>
<a name="l00140"></a>00140 <span class="stringliteral"></span>
<a name="l00141"></a>00141 <span class="stringliteral"> 8. All the architecture-dependent binary packages and the</span>
<a name="l00142"></a>00142 <span class="stringliteral"> architecture-independent ones for the `nobreakall' architectures</span>
<a name="l00143"></a>00143 <span class="stringliteral"> have to be built from the source we are considering. If this is</span>
<a name="l00144"></a>00144 <span class="stringliteral"> not true, then these are called `out-of-date' architectures and</span>
<a name="l00145"></a>00145 <span class="stringliteral"> the package is ignored.</span>
<a name="l00146"></a>00146 <span class="stringliteral"></span>
<a name="l00147"></a>00147 <span class="stringliteral"> 9. The source package must have at least a binary package, otherwise</span>
<a name="l00148"></a>00148 <span class="stringliteral"> it is ignored.</span>
<a name="l00149"></a>00149 <span class="stringliteral"></span>
<a name="l00150"></a>00150 <span class="stringliteral"> 10. If the suite is unstable, the count of release critical bugs for</span>
<a name="l00151"></a>00151 <span class="stringliteral"> the new source package must be less then the count for the testing</span>
<a name="l00152"></a>00152 <span class="stringliteral"> one. If this is not true, the package is ignored as `buggy'.</span>
<a name="l00153"></a>00153 <span class="stringliteral"></span>
<a name="l00154"></a>00154 <span class="stringliteral"> 11. If there is a `force' hint for the source package, then it is</span>
<a name="l00155"></a>00155 <span class="stringliteral"> updated even if it is marked as ignored from the previous steps.</span>
<a name="l00156"></a>00156 <span class="stringliteral"></span>
<a name="l00157"></a>00157 <span class="stringliteral"> 12. If the suite is testing-proposed-updates, the source package can</span>
<a name="l00158"></a>00158 <span class="stringliteral"> be updated only if there is an explicit approval for it.</span>
<a name="l00159"></a>00159 <span class="stringliteral"></span>
<a name="l00160"></a>00160 <span class="stringliteral"> 13. If the package will be ignored, mark it as "Valid candidate",</span>
<a name="l00161"></a>00161 <span class="stringliteral"> otherwise mark it as "Not considered".</span>
<a name="l00162"></a>00162 <span class="stringliteral"></span>
<a name="l00163"></a>00163 <span class="stringliteral"> * The list of `remove' hints is processed: if the requested source</span>
<a name="l00164"></a>00164 <span class="stringliteral"> package is not already being updated or removed and the version</span>
<a name="l00165"></a>00165 <span class="stringliteral"> actually in testing is the same specified with the `remove' hint,</span>
<a name="l00166"></a>00166 <span class="stringliteral"> it is marked for removal.</span>
<a name="l00167"></a>00167 <span class="stringliteral"></span>
<a name="l00168"></a>00168 <span class="stringliteral"> * The excuses are sorted by the number of days from the last upload</span>
<a name="l00169"></a>00169 <span class="stringliteral"> (days-old) and by name.</span>
<a name="l00170"></a>00170 <span class="stringliteral"></span>
<a name="l00171"></a>00171 <span class="stringliteral"> * A list of unconsidered excuses (for which the package is not upgraded)</span>
<a name="l00172"></a>00172 <span class="stringliteral"> is built. Using this list, all the excuses depending on them is marked</span>
<a name="l00173"></a>00173 <span class="stringliteral"> as invalid for "unpossible dependency".</span>
<a name="l00174"></a>00174 <span class="stringliteral"></span>
<a name="l00175"></a>00175 <span class="stringliteral"> * The excuses are written in an HTML file.</span>
<a name="l00176"></a>00176 <span class="stringliteral">"""</span>
<a name="l00177"></a>00177
<a name="l00178"></a>00178 <span class="keyword">import</span> os
<a name="l00179"></a>00179 <span class="keyword">import</span> re
<a name="l00180"></a>00180 <span class="keyword">import</span> sys
<a name="l00181"></a>00181 <span class="keyword">import</span> string
<a name="l00182"></a>00182 <span class="keyword">import</span> time
<a name="l00183"></a>00183 <span class="keyword">import</span> optparse
<a name="l00184"></a>00184 <span class="keyword">import</span> operator
<a name="l00185"></a>00185
<a name="l00186"></a>00186 <span class="keyword">import</span> apt_pkg
<a name="l00187"></a>00187
<a name="l00188"></a>00188 <span class="keyword">from</span> excuse <span class="keyword">import</span> Excuse
<a name="l00189"></a>00189 <span class="keyword">from</span> upgrade <span class="keyword">import</span> UpgradeRun
<a name="l00190"></a>00190
<a name="l00191"></a>00191 __author__ = <span class="stringliteral">'Fabio Tranchitella'</span>
<a name="l00192"></a>00192 __version__ = <span class="stringliteral">'2.0.alpha1'</span>
<a name="l00193"></a>00193
<a name="l00194"></a>00194
<a name="l00195"></a><a class="code" href="classbritney_1_1Britney.html">00195</a> <span class="keyword">class </span><a class="code" href="classbritney_1_1Britney.html">Britney</a>:
<a name="l00196"></a>00196 <span class="stringliteral">"""Britney, the debian testing updater script</span>
<a name="l00197"></a>00197 <span class="stringliteral"> </span>
<a name="l00198"></a><a class="code" href="classbritney_1_1Britney.html#ebbe3f40cca59e2de275b0558556ee63">00198</a> <span class="stringliteral"> This is the script that updates the testing_ distribution. It is executed</span>
<a name="l00199"></a><a class="code" href="classbritney_1_1Britney.html#a088d6fd96963f87f88c9c40cda10bfa">00199</a> <span class="stringliteral"> each day after the installation of the updated packages. It generates the </span>
<a name="l00200"></a>00200 <span class="stringliteral"> `Packages' files for the testing distribution, but it does so in an</span>
<a name="l00201"></a><a class="code" href="classbritney_1_1Britney.html#5846d81eace24f479292c47e30fd1851">00201</a> <span class="stringliteral"> intelligent manner; it try to avoid any inconsistency and to use only</span>
<a name="l00202"></a>00202 <span class="stringliteral"> non-buggy packages.</span>
<a name="l00203"></a>00203 <span class="stringliteral"></span>
<a name="l00204"></a>00204 <span class="stringliteral"> For more documentation on this script, please read the Developers Reference.</span>
<a name="l00205"></a>00205 <span class="stringliteral"> """</span>
<a name="l00206"></a>00206
<a name="l00207"></a>00207 HINTS_STANDARD = (<span class="stringliteral">"easy"</span>, <span class="stringliteral">"hint"</span>, <span class="stringliteral">"remove"</span>, <span class="stringliteral">"block"</span>, <span class="stringliteral">"unblock"</span>, <span class="stringliteral">"urgent"</span>, <span class="stringliteral">"approve"</span>)
<a name="l00208"></a>00208 HINTS_ALL = (<span class="stringliteral">"force"</span>, <span class="stringliteral">"force-hint"</span>, <span class="stringliteral">"block-all"</span>) + HINTS_STANDARD
<a name="l00209"></a>00209
<a name="l00210"></a>00210 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#5846d81eace24f479292c47e30fd1851">__init__</a>(self):
<a name="l00211"></a>00211 <span class="stringliteral">"""Class constructor</span>
<a name="l00212"></a>00212 <span class="stringliteral"></span>
<a name="l00213"></a>00213 <span class="stringliteral"> This method initializes and populates the data lists, which contain all</span>
<a name="l00214"></a>00214 <span class="stringliteral"> the information needed by the other methods of the class.</span>
<a name="l00215"></a>00215 <span class="stringliteral"> """</span>
<a name="l00216"></a>00216 self.date_now = int(((time.time() / (60*60)) - 15) / 24)
<a name="l00217"></a>00217
<a name="l00218"></a>00218 <span class="comment"># parse the command line arguments</span>
<a name="l00219"></a>00219 self.<a class="code" href="classbritney_1_1Britney.html#506f9800068902cf7cac6236b78d1dc4">__parse_arguments</a>()
<a name="l00220"></a>00220
<a name="l00221"></a>00221 <span class="comment"># initialize the apt_pkg back-end</span>
<a name="l00222"></a>00222 apt_pkg.init()
<a name="l00223"></a>00223
<a name="l00224"></a>00224 <span class="comment"># read the source and binary packages for the involved distributions</span>
<a name="l00225"></a>00225 self.sources = {<span class="stringliteral">'testing'</span>: self.<a class="code" href="classbritney_1_1Britney.html#054f44c47f17c0c4f5a069e821b7f868">read_sources</a>(self.options.testing),
<a name="l00226"></a>00226 <span class="stringliteral">'unstable'</span>: self.<a class="code" href="classbritney_1_1Britney.html#054f44c47f17c0c4f5a069e821b7f868">read_sources</a>(self.options.unstable),
<a name="l00227"></a>00227 <span class="stringliteral">'tpu'</span>: self.<a class="code" href="classbritney_1_1Britney.html#054f44c47f17c0c4f5a069e821b7f868">read_sources</a>(self.options.tpu),}
<a name="l00228"></a>00228 self.binaries = {<span class="stringliteral">'testing'</span>: {}, <span class="stringliteral">'unstable'</span>: {}, <span class="stringliteral">'tpu'</span>: {}}
<a name="l00229"></a>00229 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l00230"></a>00230 self.binaries[<span class="stringliteral">'testing'</span>][arch] = self.<a class="code" href="classbritney_1_1Britney.html#1b2b0f42e4af1cee472f93e955b30421">read_binaries</a>(self.options.testing, <span class="stringliteral">"testing"</span>, arch)
<a name="l00231"></a>00231 self.binaries[<span class="stringliteral">'unstable'</span>][arch] = self.<a class="code" href="classbritney_1_1Britney.html#1b2b0f42e4af1cee472f93e955b30421">read_binaries</a>(self.options.unstable, <span class="stringliteral">"unstable"</span>, arch)
<a name="l00232"></a>00232 self.binaries[<span class="stringliteral">'tpu'</span>][arch] = self.<a class="code" href="classbritney_1_1Britney.html#1b2b0f42e4af1cee472f93e955b30421">read_binaries</a>(self.options.tpu, <span class="stringliteral">"tpu"</span>, arch)
<a name="l00233"></a>00233
<a name="l00234"></a>00234 <span class="comment"># read the release-critical bug summaries for testing and unstable</span>
<a name="l00235"></a>00235 self.bugs = {<span class="stringliteral">'unstable'</span>: self.<a class="code" href="classbritney_1_1Britney.html#6c777aae69e7bec2efebaf23ddd4a86c">read_bugs</a>(self.options.unstable),
<a name="l00236"></a>00236 <span class="stringliteral">'testing'</span>: self.<a class="code" href="classbritney_1_1Britney.html#6c777aae69e7bec2efebaf23ddd4a86c">read_bugs</a>(self.options.testing),}
<a name="l00237"></a>00237 self.<a class="code" href="classbritney_1_1Britney.html#5a6af4a100cfd54e872a27fa7f48ac3c">normalize_bugs</a>()
<a name="l00238"></a>00238
<a name="l00239"></a>00239 <span class="comment"># read additional data</span>
<a name="l00240"></a>00240 self.dates = self.<a class="code" href="classbritney_1_1Britney.html#085af5ac906813ea40fc2e623748f517">read_dates</a>(self.options.testing)
<a name="l00241"></a>00241 self.urgencies = self.<a class="code" href="classbritney_1_1Britney.html#09fc27899506b4830b1961f125a7b6a4">read_urgencies</a>(self.options.testing)
<a name="l00242"></a>00242 self.approvals = self.<a class="code" href="classbritney_1_1Britney.html#39248f0cfea1c8798b2ca5a97d37eaf8">read_approvals</a>(self.options.tpu)
<a name="l00243"></a>00243 self.hints = self.<a class="code" href="classbritney_1_1Britney.html#46d535f617fcf1faaaf5d841ea23c184">read_hints</a>(self.options.unstable)
<a name="l00244"></a>00244 self.excuses = []
<a name="l00245"></a>00245
<a name="l00246"></a>00246 <span class="keyword">def </span>__parse_arguments(self):
<a name="l00247"></a>00247 <span class="stringliteral">"""Parse the command line arguments</span>
<a name="l00248"></a>00248 <span class="stringliteral"></span>
<a name="l00249"></a>00249 <span class="stringliteral"> This method parses and initializes the command line arguments.</span>
<a name="l00250"></a>00250 <span class="stringliteral"> While doing so, it preprocesses some of the options to be converted</span>
<a name="l00251"></a>00251 <span class="stringliteral"> in a suitable form for the other methods of the class.</span>
<a name="l00252"></a>00252 <span class="stringliteral"> """</span>
<a name="l00253"></a>00253 <span class="comment"># initialize the parser</span>
<a name="l00254"></a>00254 self.parser = optparse.OptionParser(version=<span class="stringliteral">"%prog"</span>)
<a name="l00255"></a>00255 self.parser.add_option(<span class="stringliteral">"-v"</span>, <span class="stringliteral">""</span>, action=<span class="stringliteral">"count"</span>, dest=<span class="stringliteral">"verbose"</span>, help=<span class="stringliteral">"enable verbose output"</span>)
<a name="l00256"></a>00256 self.parser.add_option(<span class="stringliteral">"-c"</span>, <span class="stringliteral">"--config"</span>, action=<span class="stringliteral">"store"</span>, dest=<span class="stringliteral">"config"</span>,
<a name="l00257"></a>00257 default=<span class="stringliteral">"/etc/britney.conf"</span>, help=<span class="stringliteral">"path for the configuration file"</span>)
<a name="l00258"></a>00258 (self.options, self.args) = self.parser.parse_args()
<a name="l00259"></a>00259
<a name="l00260"></a>00260 <span class="comment"># if the configuration file exists, than read it and set the additional options</span>
<a name="l00261"></a>00261 <span class="keywordflow">if</span> <span class="keywordflow">not</span> os.path.isfile(self.options.config):
<a name="l00262"></a>00262 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Unable to read the configuration file (%s), exiting!"</span> % self.options.config, type=<span class="stringliteral">"E"</span>)
<a name="l00263"></a>00263 sys.exit(1)
<a name="l00264"></a>00264
<a name="l00265"></a>00265 <span class="comment"># minimum days for unstable-testing transition and the list of hints</span>
<a name="l00266"></a>00266 <span class="comment"># are handled as an ad-hoc case</span>
<a name="l00267"></a>00267 self.MINDAYS = {}
<a name="l00268"></a>00268 self.HINTS = {}
<a name="l00269"></a>00269 <span class="keywordflow">for</span> k, v <span class="keywordflow">in</span> [map(string.strip,r.split(<span class="stringliteral">'='</span>, 1)) <span class="keywordflow">for</span> r <span class="keywordflow">in</span> file(self.options.config) <span class="keywordflow">if</span> <span class="stringliteral">'='</span> <span class="keywordflow">in</span> r <span class="keywordflow">and</span> <span class="keywordflow">not</span> r.strip().startswith(<span class="stringliteral">'#'</span>)]:
<a name="l00270"></a>00270 <span class="keywordflow">if</span> k.startswith(<span class="stringliteral">"MINDAYS_"</span>):
<a name="l00271"></a>00271 self.MINDAYS[k.split(<span class="stringliteral">"_"</span>)[1].lower()] = int(v)
<a name="l00272"></a>00272 <span class="keywordflow">elif</span> k.startswith(<span class="stringliteral">"HINTS_"</span>):
<a name="l00273"></a>00273 self.HINTS[k.split(<span class="stringliteral">"_"</span>)[1].lower()] = \
<a name="l00274"></a>00274 reduce(<span class="keyword">lambda</span> x,y: x+y, [hasattr(self, <span class="stringliteral">"HINTS_"</span> + i) <span class="keywordflow">and</span> getattr(self, <span class="stringliteral">"HINTS_"</span> + i) <span class="keywordflow">or</span> (i,) <span class="keywordflow">for</span> i <span class="keywordflow">in</span> v.split()])
<a name="l00275"></a>00275 <span class="keywordflow">else</span>:
<a name="l00276"></a>00276 setattr(self.options, k.lower(), v)
<a name="l00277"></a>00277
<a name="l00278"></a>00278 <span class="comment"># Sort the architecture list</span>
<a name="l00279"></a>00279 allarches = sorted(self.options.architectures.split())
<a name="l00280"></a>00280 arches = [x <span class="keywordflow">for</span> x <span class="keywordflow">in</span> allarches <span class="keywordflow">if</span> x <span class="keywordflow">in</span> self.options.nobreakall_arches]
<a name="l00281"></a>00281 arches += [x <span class="keywordflow">for</span> x <span class="keywordflow">in</span> allarches <span class="keywordflow">if</span> x <span class="keywordflow">not</span> <span class="keywordflow">in</span> arches <span class="keywordflow">and</span> x <span class="keywordflow">not</span> <span class="keywordflow">in</span> self.options.fucked_arches]
<a name="l00282"></a>00282 arches += [x <span class="keywordflow">for</span> x <span class="keywordflow">in</span> allarches <span class="keywordflow">if</span> x <span class="keywordflow">not</span> <span class="keywordflow">in</span> arches <span class="keywordflow">and</span> x <span class="keywordflow">not</span> <span class="keywordflow">in</span> self.options.break_arches]
<a name="l00283"></a>00283 arches += [x <span class="keywordflow">for</span> x <span class="keywordflow">in</span> allarches <span class="keywordflow">if</span> x <span class="keywordflow">not</span> <span class="keywordflow">in</span> arches]
<a name="l00284"></a>00284 self.options.architectures = arches
<a name="l00285"></a>00285
<a name="l00286"></a>00286 <span class="keyword">def </span>__log(self, msg, type="I"):
<a name="l00287"></a>00287 <span class="stringliteral">"""Print info messages according to verbosity level</span>
<a name="l00288"></a>00288 <span class="stringliteral"> </span>
<a name="l00289"></a>00289 <span class="stringliteral"> An easy-and-simple log method which prints messages to the standard</span>
<a name="l00290"></a>00290 <span class="stringliteral"> output. The type parameter controls the urgency of the message, and</span>
<a name="l00291"></a>00291 <span class="stringliteral"> can be equal to `I' for `Information', `W' for `Warning' and `E' for</span>
<a name="l00292"></a><a class="code" href="classbritney_1_1Britney.html#054f44c47f17c0c4f5a069e821b7f868">00292</a> <span class="stringliteral"> `Error'. Warnings and errors are always printed, and information are</span>
<a name="l00293"></a>00293 <span class="stringliteral"> printed only if the verbose logging is enabled.</span>
<a name="l00294"></a>00294 <span class="stringliteral"> """</span>
<a name="l00295"></a>00295 <span class="keywordflow">if</span> self.options.verbose <span class="keywordflow">or</span> type <span class="keywordflow">in</span> (<span class="stringliteral">"E"</span>, <span class="stringliteral">"W"</span>):
<a name="l00296"></a>00296 <span class="keywordflow">print</span> <span class="stringliteral">"%s: [%s] - %s"</span> % (type, time.asctime(), msg)
<a name="l00297"></a>00297
<a name="l00298"></a>00298 <span class="comment"># Data reading/writing methods</span>
<a name="l00299"></a>00299 <span class="comment"># ----------------------------</span>
<a name="l00300"></a>00300
<a name="l00301"></a>00301 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#054f44c47f17c0c4f5a069e821b7f868">read_sources</a>(self, basedir):
<a name="l00302"></a>00302 <span class="stringliteral">"""Read the list of source packages from the specified directory</span>
<a name="l00303"></a>00303 <span class="stringliteral"> </span>
<a name="l00304"></a>00304 <span class="stringliteral"> The source packages are read from the `Sources' file within the</span>
<a name="l00305"></a>00305 <span class="stringliteral"> directory specified as `basedir' parameter. Considering the</span>
<a name="l00306"></a>00306 <span class="stringliteral"> large amount of memory needed, not all the fields are loaded</span>
<a name="l00307"></a>00307 <span class="stringliteral"> in memory. The available fields are Version, Maintainer and Section.</span>
<a name="l00308"></a>00308 <span class="stringliteral"></span>
<a name="l00309"></a>00309 <span class="stringliteral"> The method returns a list where every item represents a source</span>
<a name="l00310"></a>00310 <span class="stringliteral"> package as a dictionary.</span>
<a name="l00311"></a>00311 <span class="stringliteral"> """</span>
<a name="l00312"></a>00312 sources = {}
<a name="l00313"></a>00313 package = <span class="keywordtype">None</span>
<a name="l00314"></a>00314 filename = os.path.join(basedir, <span class="stringliteral">"Sources"</span>)
<a name="l00315"></a>00315 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Loading source packages from %s"</span> % filename)
<a name="l00316"></a>00316 packages = apt_pkg.ParseTagFile(open(filename))
<a name="l00317"></a><a class="code" href="classbritney_1_1Britney.html#1b2b0f42e4af1cee472f93e955b30421">00317</a> <span class="keywordflow">while</span> packages.Step():
<a name="l00318"></a>00318 pkg = packages.Section.get(<span class="stringliteral">'Package'</span>)
<a name="l00319"></a>00319 sources[pkg] = {<span class="stringliteral">'binaries'</span>: [],
<a name="l00320"></a>00320 <span class="stringliteral">'version'</span>: packages.Section.get(<span class="stringliteral">'Version'</span>),
<a name="l00321"></a>00321 <span class="stringliteral">'maintainer'</span>: packages.Section.get(<span class="stringliteral">'Maintainer'</span>),
<a name="l00322"></a>00322 <span class="stringliteral">'section'</span>: packages.Section.get(<span class="stringliteral">'Section'</span>),
<a name="l00323"></a>00323 }
<a name="l00324"></a>00324 <span class="keywordflow">return</span> sources
<a name="l00325"></a>00325
<a name="l00326"></a>00326 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#1b2b0f42e4af1cee472f93e955b30421">read_binaries</a>(self, basedir, distribution, arch):
<a name="l00327"></a>00327 <span class="stringliteral">"""Read the list of binary packages from the specified directory</span>
<a name="l00328"></a>00328 <span class="stringliteral"> </span>
<a name="l00329"></a>00329 <span class="stringliteral"> The binary packages are read from the `Packages_${arch}' files</span>
<a name="l00330"></a>00330 <span class="stringliteral"> within the directory specified as `basedir' parameter, replacing</span>
<a name="l00331"></a>00331 <span class="stringliteral"> ${arch} with the value of the arch parameter. Considering the</span>
<a name="l00332"></a>00332 <span class="stringliteral"> large amount of memory needed, not all the fields are loaded</span>
<a name="l00333"></a>00333 <span class="stringliteral"> in memory. The available fields are Version, Source, Pre-Depends,</span>
<a name="l00334"></a>00334 <span class="stringliteral"> Depends, Conflicts, Provides and Architecture.</span>
<a name="l00335"></a>00335 <span class="stringliteral"> </span>
<a name="l00336"></a>00336 <span class="stringliteral"> After reading the packages, reverse dependencies are computed</span>
<a name="l00337"></a>00337 <span class="stringliteral"> and saved in the `rdepends' keys, and the `Provides' field is</span>
<a name="l00338"></a>00338 <span class="stringliteral"> used to populate the virtual packages list.</span>
<a name="l00339"></a>00339 <span class="stringliteral"></span>
<a name="l00340"></a>00340 <span class="stringliteral"> The dependencies are parsed with the apt.pkg.ParseDepends method,</span>
<a name="l00341"></a>00341 <span class="stringliteral"> and they are stored both as the format of its return value and</span>
<a name="l00342"></a>00342 <span class="stringliteral"> text.</span>
<a name="l00343"></a>00343 <span class="stringliteral"></span>
<a name="l00344"></a>00344 <span class="stringliteral"> The method returns a tuple. The first element is a list where</span>
<a name="l00345"></a>00345 <span class="stringliteral"> every item represents a binary package as a dictionary; the second</span>
<a name="l00346"></a>00346 <span class="stringliteral"> element is a dictionary which maps virtual packages to real</span>
<a name="l00347"></a>00347 <span class="stringliteral"> packages that provide it.</span>
<a name="l00348"></a>00348 <span class="stringliteral"> """</span>
<a name="l00349"></a>00349
<a name="l00350"></a>00350 packages = {}
<a name="l00351"></a>00351 provides = {}
<a name="l00352"></a>00352 package = <span class="keywordtype">None</span>
<a name="l00353"></a>00353 filename = os.path.join(basedir, <span class="stringliteral">"Packages_%s"</span> % arch)
<a name="l00354"></a>00354 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Loading binary packages from %s"</span> % filename)
<a name="l00355"></a>00355 Packages = apt_pkg.ParseTagFile(open(filename))
<a name="l00356"></a>00356 <span class="keywordflow">while</span> Packages.Step():
<a name="l00357"></a>00357 pkg = Packages.Section.get(<span class="stringliteral">'Package'</span>)
<a name="l00358"></a>00358 version = Packages.Section.get(<span class="stringliteral">'Version'</span>)
<a name="l00359"></a>00359 dpkg = {<span class="stringliteral">'version'</span>: version,
<a name="l00360"></a>00360 <span class="stringliteral">'source'</span>: pkg,
<a name="l00361"></a>00361 <span class="stringliteral">'source-ver'</span>: version,
<a name="l00362"></a>00362 <span class="stringliteral">'architecture'</span>: Packages.Section.get(<span class="stringliteral">'Architecture'</span>),
<a name="l00363"></a>00363 <span class="stringliteral">'rdepends'</span>: [],
<a name="l00364"></a>00364 }
<a name="l00365"></a>00365 <span class="keywordflow">for</span> k <span class="keywordflow">in</span> (<span class="stringliteral">'Pre-Depends'</span>, <span class="stringliteral">'Depends'</span>, <span class="stringliteral">'Provides'</span>, <span class="stringliteral">'Conflicts'</span>):
<a name="l00366"></a>00366 v = Packages.Section.get(k)
<a name="l00367"></a>00367 <span class="keywordflow">if</span> v: dpkg[k.lower()] = v
<a name="l00368"></a>00368
<a name="l00369"></a>00369 <span class="comment"># retrieve the name and the version of the source package</span>
<a name="l00370"></a>00370 source = Packages.Section.get(<span class="stringliteral">'Source'</span>)
<a name="l00371"></a>00371 <span class="keywordflow">if</span> source:
<a name="l00372"></a>00372 dpkg[<span class="stringliteral">'source'</span>] = source.split(<span class="stringliteral">" "</span>)[0]
<a name="l00373"></a>00373 <span class="keywordflow">if</span> <span class="stringliteral">"("</span> <span class="keywordflow">in</span> source:
<a name="l00374"></a>00374 dpkg[<span class="stringliteral">'source-ver'</span>] = source.split(<span class="stringliteral">"("</span>)[1].split(<span class="stringliteral">")"</span>)[0]
<a name="l00375"></a>00375
<a name="l00376"></a>00376 <span class="comment"># if the source package is available in the distribution, then register this binary package</span>
<a name="l00377"></a>00377 <span class="keywordflow">if</span> dpkg[<span class="stringliteral">'source'</span>] <span class="keywordflow">in</span> self.sources[distribution]:
<a name="l00378"></a>00378 self.sources[distribution][dpkg[<span class="stringliteral">'source'</span>]][<span class="stringliteral">'binaries'</span>].append(pkg + <span class="stringliteral">"/"</span> + arch)
<a name="l00379"></a>00379 <span class="comment"># if the source package doesn't exist, create a fake one</span>
<a name="l00380"></a>00380 <span class="keywordflow">else</span>:
<a name="l00381"></a>00381 self.sources[distribution][dpkg[<span class="stringliteral">'source'</span>]] = {<span class="stringliteral">'binaries'</span>: [pkg + <span class="stringliteral">"/"</span> + arch],
<a name="l00382"></a>00382 <span class="stringliteral">'version'</span>: dpkg[<span class="stringliteral">'source-ver'</span>], <span class="stringliteral">'maintainer'</span>: <span class="keywordtype">None</span>, <span class="stringliteral">'section'</span>: <span class="keywordtype">None</span>, <span class="stringliteral">'fake'</span>: <span class="keyword">True</span>}
<a name="l00383"></a>00383
<a name="l00384"></a>00384 <span class="comment"># register virtual packages and real packages that provide them</span>
<a name="l00385"></a>00385 <span class="keywordflow">if</span> dpkg.has_key(<span class="stringliteral">'provides'</span>):
<a name="l00386"></a>00386 parts = map(string.strip, dpkg[<span class="stringliteral">'provides'</span>].split(<span class="stringliteral">","</span>))
<a name="l00387"></a>00387 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> parts:
<a name="l00388"></a>00388 <span class="keywordflow">try</span>:
<a name="l00389"></a>00389 provides[p].append(pkg)
<a name="l00390"></a>00390 <span class="keywordflow">except</span> KeyError:
<a name="l00391"></a>00391 provides[p] = [pkg]
<a name="l00392"></a>00392 del dpkg[<span class="stringliteral">'provides'</span>]
<a name="l00393"></a>00393
<a name="l00394"></a>00394 <span class="comment"># append the resulting dictionary to the package list</span>
<a name="l00395"></a>00395 packages[pkg] = dpkg
<a name="l00396"></a>00396
<a name="l00397"></a>00397 <span class="comment"># loop again on the list of packages to register reverse dependencies</span>
<a name="l00398"></a>00398 <span class="comment"># this is not needed for the moment, so it is disabled</span>
<a name="l00399"></a>00399 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> packages:
<a name="l00400"></a>00400 dependencies = []
<a name="l00401"></a>00401 <span class="keywordflow">if</span> packages[pkg].has_key(<span class="stringliteral">'depends'</span>):
<a name="l00402"></a>00402 dependencies.extend(apt_pkg.ParseDepends(packages[pkg][<span class="stringliteral">'depends'</span>]))
<a name="l00403"></a>00403 <span class="keywordflow">if</span> packages[pkg].has_key(<span class="stringliteral">'pre-depends'</span>):
<a name="l00404"></a>00404 dependencies.extend(apt_pkg.ParseDepends(packages[pkg][<span class="stringliteral">'pre-depends'</span>]))
<a name="l00405"></a>00405 <span class="comment"># register the list of the dependencies for the depending packages</span>
<a name="l00406"></a><a class="code" href="classbritney_1_1Britney.html#6c777aae69e7bec2efebaf23ddd4a86c">00406</a> <span class="keywordflow">for</span> p <span class="keywordflow">in</span> dependencies:
<a name="l00407"></a>00407 <span class="keywordflow">for</span> a <span class="keywordflow">in</span> p:
<a name="l00408"></a>00408 <span class="keywordflow">if</span> a[0] <span class="keywordflow">not</span> <span class="keywordflow">in</span> packages: <span class="keywordflow">continue</span>
<a name="l00409"></a>00409 packages[a[0]][<span class="stringliteral">'rdepends'</span>].append((pkg, a[1], a[2]))
<a name="l00410"></a>00410 del dependencies
<a name="l00411"></a>00411
<a name="l00412"></a>00412 <span class="comment"># return a tuple with the list of real and virtual packages</span>
<a name="l00413"></a>00413 <span class="keywordflow">return</span> (packages, provides)
<a name="l00414"></a>00414
<a name="l00415"></a>00415 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#6c777aae69e7bec2efebaf23ddd4a86c">read_bugs</a>(self, basedir):
<a name="l00416"></a>00416 <span class="stringliteral">"""Read the release critial bug summary from the specified directory</span>
<a name="l00417"></a>00417 <span class="stringliteral"> </span>
<a name="l00418"></a>00418 <span class="stringliteral"> The RC bug summaries are read from the `Bugs' file within the</span>
<a name="l00419"></a>00419 <span class="stringliteral"> directory specified as `basedir' parameter. The file contains</span>
<a name="l00420"></a>00420 <span class="stringliteral"> rows with the format:</span>
<a name="l00421"></a>00421 <span class="stringliteral"></span>
<a name="l00422"></a>00422 <span class="stringliteral"> &lt;package-name&gt; &lt;count-of-rc-bugs&gt;</span>
<a name="l00423"></a>00423 <span class="stringliteral"></span>
<a name="l00424"></a>00424 <span class="stringliteral"> The method returns a dictionary where the key is the binary package</span>
<a name="l00425"></a>00425 <span class="stringliteral"> name and the value is the number of open RC bugs for it.</span>
<a name="l00426"></a>00426 <span class="stringliteral"> """</span>
<a name="l00427"></a>00427 bugs = {}
<a name="l00428"></a>00428 filename = os.path.join(basedir, <span class="stringliteral">"Bugs"</span>)
<a name="l00429"></a>00429 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Loading RC bugs count from %s"</span> % filename)
<a name="l00430"></a>00430 <span class="keywordflow">for</span> line <span class="keywordflow">in</span> open(filename):
<a name="l00431"></a>00431 l = line.strip().split()
<a name="l00432"></a>00432 <span class="keywordflow">if</span> len(l) != 2: <span class="keywordflow">continue</span>
<a name="l00433"></a>00433 <span class="keywordflow">try</span>:
<a name="l00434"></a>00434 bugs[l[0]] = int(l[1])
<a name="l00435"></a>00435 <span class="keywordflow">except</span> ValueError:
<a name="l00436"></a>00436 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Bugs, unable to parse \"%s\""</span> % line, type=<span class="stringliteral">"E"</span>)
<a name="l00437"></a>00437 <span class="keywordflow">return</span> bugs
<a name="l00438"></a>00438
<a name="l00439"></a>00439 <span class="keyword">def </span>__maxver(self, pkg, dist):
<a name="l00440"></a>00440 <span class="stringliteral">"""Return the maximum version for a given package name</span>
<a name="l00441"></a>00441 <span class="stringliteral"> </span>
<a name="l00442"></a>00442 <span class="stringliteral"> This method returns None if the specified source package</span>
<a name="l00443"></a>00443 <span class="stringliteral"> is not available in the `dist' distribution. If the package</span>
<a name="l00444"></a>00444 <span class="stringliteral"> exists, then it returns the maximum version between the</span>
<a name="l00445"></a>00445 <span class="stringliteral"> source package and its binary packages.</span>
<a name="l00446"></a>00446 <span class="stringliteral"> """</span>
<a name="l00447"></a>00447 maxver = <span class="keywordtype">None</span>
<a name="l00448"></a><a class="code" href="classbritney_1_1Britney.html#5a6af4a100cfd54e872a27fa7f48ac3c">00448</a> <span class="keywordflow">if</span> self.sources[dist].has_key(pkg):
<a name="l00449"></a>00449 maxver = self.sources[dist][pkg][<span class="stringliteral">'version'</span>]
<a name="l00450"></a>00450 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l00451"></a>00451 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.binaries[dist][arch][0].has_key(pkg): <span class="keywordflow">continue</span>
<a name="l00452"></a>00452 pkgv = self.binaries[dist][arch][0][pkg][<span class="stringliteral">'version'</span>]
<a name="l00453"></a>00453 <span class="keywordflow">if</span> maxver == <span class="keywordtype">None</span> <span class="keywordflow">or</span> apt_pkg.VersionCompare(pkgv, maxver) &gt; 0:
<a name="l00454"></a>00454 maxver = pkgv
<a name="l00455"></a>00455 <span class="keywordflow">return</span> maxver
<a name="l00456"></a>00456
<a name="l00457"></a>00457 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#5a6af4a100cfd54e872a27fa7f48ac3c">normalize_bugs</a>(self):
<a name="l00458"></a>00458 <span class="stringliteral">"""Normalize the release critical bug summaries for testing and unstable</span>
<a name="l00459"></a>00459 <span class="stringliteral"> </span>
<a name="l00460"></a>00460 <span class="stringliteral"> The method doesn't return any value: it directly modifies the</span>
<a name="l00461"></a>00461 <span class="stringliteral"> object attribute `bugs'.</span>
<a name="l00462"></a>00462 <span class="stringliteral"> """</span>
<a name="l00463"></a>00463 <span class="comment"># loop on all the package names from testing and unstable bug summaries</span>
<a name="l00464"></a>00464 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> set(self.bugs[<span class="stringliteral">'testing'</span>].keys() + self.bugs[<span class="stringliteral">'unstable'</span>].keys()):
<a name="l00465"></a>00465
<a name="l00466"></a>00466 <span class="comment"># make sure that the key is present in both dictionaries</span>
<a name="l00467"></a>00467 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.bugs[<span class="stringliteral">'testing'</span>].has_key(pkg):
<a name="l00468"></a>00468 self.bugs[<span class="stringliteral">'testing'</span>][pkg] = 0
<a name="l00469"></a>00469 <span class="keywordflow">elif</span> <span class="keywordflow">not</span> self.bugs[<span class="stringliteral">'unstable'</span>].has_key(pkg):
<a name="l00470"></a>00470 self.bugs[<span class="stringliteral">'unstable'</span>][pkg] = 0
<a name="l00471"></a>00471
<a name="l00472"></a>00472 <span class="comment"># retrieve the maximum version of the package in testing:</span>
<a name="l00473"></a>00473 maxvert = self.<a class="code" href="classbritney_1_1Britney.html#0affb1945986a52c61a4492c9732968e">__maxver</a>(pkg, <span class="stringliteral">'testing'</span>)
<a name="l00474"></a>00474
<a name="l00475"></a>00475 <span class="comment"># if the package is not available in testing or it has the</span>
<a name="l00476"></a>00476 <span class="comment"># same RC bug count, then do nothing</span>
<a name="l00477"></a>00477 <span class="keywordflow">if</span> maxvert == <span class="keywordtype">None</span> <span class="keywordflow">or</span> \
<a name="l00478"></a>00478 self.bugs[<span class="stringliteral">'testing'</span>][pkg] == self.bugs[<span class="stringliteral">'unstable'</span>][pkg]:
<a name="l00479"></a>00479 <span class="keywordflow">continue</span>
<a name="l00480"></a>00480
<a name="l00481"></a>00481 <span class="comment"># retrieve the maximum version of the package in testing:</span>
<a name="l00482"></a>00482 maxveru = self.<a class="code" href="classbritney_1_1Britney.html#0affb1945986a52c61a4492c9732968e">__maxver</a>(pkg, <span class="stringliteral">'unstable'</span>)
<a name="l00483"></a><a class="code" href="classbritney_1_1Britney.html#085af5ac906813ea40fc2e623748f517">00483</a>
<a name="l00484"></a>00484 <span class="comment"># if the package is not available in unstable, then do nothing</span>
<a name="l00485"></a>00485 <span class="keywordflow">if</span> maxveru == <span class="keywordtype">None</span>:
<a name="l00486"></a>00486 <span class="keywordflow">continue</span>
<a name="l00487"></a>00487 <span class="comment"># else if the testing package is more recent, then use the</span>
<a name="l00488"></a>00488 <span class="comment"># unstable RC bug count for testing, too</span>
<a name="l00489"></a>00489 <span class="keywordflow">elif</span> apt_pkg.VersionCompare(maxvert, maxveru) &gt;= 0:
<a name="l00490"></a>00490 self.bugs[<span class="stringliteral">'testing'</span>][pkg] = self.bugs[<span class="stringliteral">'unstable'</span>][pkg]
<a name="l00491"></a>00491
<a name="l00492"></a>00492 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#085af5ac906813ea40fc2e623748f517">read_dates</a>(self, basedir):
<a name="l00493"></a>00493 <span class="stringliteral">"""Read the upload date for the packages from the specified directory</span>
<a name="l00494"></a>00494 <span class="stringliteral"> </span>
<a name="l00495"></a>00495 <span class="stringliteral"> The upload dates are read from the `Date' file within the directory</span>
<a name="l00496"></a>00496 <span class="stringliteral"> specified as `basedir' parameter. The file contains rows with the</span>
<a name="l00497"></a>00497 <span class="stringliteral"> format:</span>
<a name="l00498"></a>00498 <span class="stringliteral"></span>
<a name="l00499"></a>00499 <span class="stringliteral"> &lt;package-name&gt; &lt;version&gt; &lt;date-of-upload&gt;</span>
<a name="l00500"></a>00500 <span class="stringliteral"></span>
<a name="l00501"></a>00501 <span class="stringliteral"> The dates are expressed as days starting from the 1970-01-01.</span>
<a name="l00502"></a>00502 <span class="stringliteral"></span>
<a name="l00503"></a>00503 <span class="stringliteral"> The method returns a dictionary where the key is the binary package</span>
<a name="l00504"></a>00504 <span class="stringliteral"> name and the value is tuple with two items, the version and the date.</span>
<a name="l00505"></a>00505 <span class="stringliteral"> """</span>
<a name="l00506"></a>00506 dates = {}
<a name="l00507"></a>00507 filename = os.path.join(basedir, <span class="stringliteral">"Dates"</span>)
<a name="l00508"></a>00508 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Loading upload data from %s"</span> % filename)
<a name="l00509"></a><a class="code" href="classbritney_1_1Britney.html#09fc27899506b4830b1961f125a7b6a4">00509</a> <span class="keywordflow">for</span> line <span class="keywordflow">in</span> open(filename):
<a name="l00510"></a>00510 l = line.strip().split()
<a name="l00511"></a>00511 <span class="keywordflow">if</span> len(l) != 3: <span class="keywordflow">continue</span>
<a name="l00512"></a>00512 <span class="keywordflow">try</span>:
<a name="l00513"></a>00513 dates[l[0]] = (l[1], int(l[2]))
<a name="l00514"></a>00514 <span class="keywordflow">except</span> ValueError:
<a name="l00515"></a>00515 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Dates, unable to parse \"%s\""</span> % line, type=<span class="stringliteral">"E"</span>)
<a name="l00516"></a>00516 <span class="keywordflow">return</span> dates
<a name="l00517"></a>00517
<a name="l00518"></a>00518 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#09fc27899506b4830b1961f125a7b6a4">read_urgencies</a>(self, basedir):
<a name="l00519"></a>00519 <span class="stringliteral">"""Read the upload urgency of the packages from the specified directory</span>
<a name="l00520"></a>00520 <span class="stringliteral"> </span>
<a name="l00521"></a>00521 <span class="stringliteral"> The upload urgencies are read from the `Urgency' file within the</span>
<a name="l00522"></a>00522 <span class="stringliteral"> directory specified as `basedir' parameter. The file contains rows</span>
<a name="l00523"></a>00523 <span class="stringliteral"> with the format:</span>
<a name="l00524"></a>00524 <span class="stringliteral"></span>
<a name="l00525"></a>00525 <span class="stringliteral"> &lt;package-name&gt; &lt;version&gt; &lt;urgency&gt;</span>
<a name="l00526"></a>00526 <span class="stringliteral"></span>
<a name="l00527"></a>00527 <span class="stringliteral"> The method returns a dictionary where the key is the binary package</span>
<a name="l00528"></a>00528 <span class="stringliteral"> name and the value is the greatest urgency from the versions of the</span>
<a name="l00529"></a>00529 <span class="stringliteral"> package that are higher then the testing one.</span>
<a name="l00530"></a>00530 <span class="stringliteral"> """</span>
<a name="l00531"></a>00531
<a name="l00532"></a>00532 urgencies = {}
<a name="l00533"></a>00533 filename = os.path.join(basedir, <span class="stringliteral">"Urgency"</span>)
<a name="l00534"></a>00534 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Loading upload urgencies from %s"</span> % filename)
<a name="l00535"></a>00535 <span class="keywordflow">for</span> line <span class="keywordflow">in</span> open(filename):
<a name="l00536"></a>00536 l = line.strip().split()
<a name="l00537"></a>00537 <span class="keywordflow">if</span> len(l) != 3: <span class="keywordflow">continue</span>
<a name="l00538"></a>00538
<a name="l00539"></a>00539 <span class="comment"># read the minimum days associated to the urgencies</span>
<a name="l00540"></a>00540 urgency_old = urgencies.get(l[0], self.options.default_urgency)
<a name="l00541"></a>00541 mindays_old = self.MINDAYS.get(urgency_old, self.MINDAYS[self.options.default_urgency])
<a name="l00542"></a>00542 mindays_new = self.MINDAYS.get(l[2], self.MINDAYS[self.options.default_urgency])
<a name="l00543"></a>00543
<a name="l00544"></a>00544 <span class="comment"># if the new urgency is lower (so the min days are higher), do nothing</span>
<a name="l00545"></a>00545 <span class="keywordflow">if</span> mindays_old &lt;= mindays_new:
<a name="l00546"></a>00546 <span class="keywordflow">continue</span>
<a name="l00547"></a>00547
<a name="l00548"></a>00548 <span class="comment"># if the package exists in testing and it is more recent, do nothing</span>
<a name="l00549"></a>00549 tsrcv = self.sources[<span class="stringliteral">'testing'</span>].get(l[0], <span class="keywordtype">None</span>)
<a name="l00550"></a>00550 <span class="keywordflow">if</span> tsrcv <span class="keywordflow">and</span> apt_pkg.VersionCompare(tsrcv[<span class="stringliteral">'version'</span>], l[1]) &gt;= 0:
<a name="l00551"></a>00551 <span class="keywordflow">continue</span>
<a name="l00552"></a>00552
<a name="l00553"></a>00553 <span class="comment"># if the package doesn't exist in unstable or it is older, do nothing</span>
<a name="l00554"></a><a class="code" href="classbritney_1_1Britney.html#39248f0cfea1c8798b2ca5a97d37eaf8">00554</a> usrcv = self.sources[<span class="stringliteral">'unstable'</span>].get(l[0], <span class="keywordtype">None</span>)
<a name="l00555"></a>00555 <span class="keywordflow">if</span> <span class="keywordflow">not</span> usrcv <span class="keywordflow">or</span> apt_pkg.VersionCompare(usrcv[<span class="stringliteral">'version'</span>], l[1]) &lt; 0:
<a name="l00556"></a>00556 <span class="keywordflow">continue</span>
<a name="l00557"></a>00557
<a name="l00558"></a>00558 <span class="comment"># update the urgency for the package</span>
<a name="l00559"></a>00559 urgencies[l[0]] = l[2]
<a name="l00560"></a>00560
<a name="l00561"></a>00561 <span class="keywordflow">return</span> urgencies
<a name="l00562"></a>00562
<a name="l00563"></a>00563 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#39248f0cfea1c8798b2ca5a97d37eaf8">read_approvals</a>(self, basedir):
<a name="l00564"></a>00564 <span class="stringliteral">"""Read the approval commands from the specified directory</span>
<a name="l00565"></a>00565 <span class="stringliteral"> </span>
<a name="l00566"></a>00566 <span class="stringliteral"> The approval commands are read from the files contained by the </span>
<a name="l00567"></a>00567 <span class="stringliteral"> `Approved' directory within the directory specified as `basedir'</span>
<a name="l00568"></a>00568 <span class="stringliteral"> parameter. The name of the files has to be the same of the</span>
<a name="l00569"></a>00569 <span class="stringliteral"> authorized users for the approvals.</span>
<a name="l00570"></a>00570 <span class="stringliteral"> </span>
<a name="l00571"></a>00571 <span class="stringliteral"> The file contains rows with the format:</span>
<a name="l00572"></a>00572 <span class="stringliteral"></span>
<a name="l00573"></a>00573 <span class="stringliteral"> &lt;package-name&gt; &lt;version&gt;</span>
<a name="l00574"></a>00574 <span class="stringliteral"></span>
<a name="l00575"></a>00575 <span class="stringliteral"> The method returns a dictionary where the key is the binary package</span>
<a name="l00576"></a>00576 <span class="stringliteral"> name followed by an underscore and the version number, and the value</span>
<a name="l00577"></a>00577 <span class="stringliteral"> is the user who submitted the command.</span>
<a name="l00578"></a>00578 <span class="stringliteral"> """</span>
<a name="l00579"></a>00579 approvals = {}
<a name="l00580"></a><a class="code" href="classbritney_1_1Britney.html#46d535f617fcf1faaaf5d841ea23c184">00580</a> <span class="keywordflow">for</span> approver <span class="keywordflow">in</span> self.options.approvers.split():
<a name="l00581"></a>00581 filename = os.path.join(basedir, <span class="stringliteral">"Approved"</span>, approver)
<a name="l00582"></a>00582 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Loading approvals list from %s"</span> % filename)
<a name="l00583"></a>00583 <span class="keywordflow">for</span> line <span class="keywordflow">in</span> open(filename):
<a name="l00584"></a>00584 l = line.strip().split()
<a name="l00585"></a>00585 <span class="keywordflow">if</span> len(l) != 2: <span class="keywordflow">continue</span>
<a name="l00586"></a>00586 approvals[<span class="stringliteral">"%s_%s"</span> % (l[0], l[1])] = approver
<a name="l00587"></a>00587 <span class="keywordflow">return</span> approvals
<a name="l00588"></a>00588
<a name="l00589"></a>00589 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#46d535f617fcf1faaaf5d841ea23c184">read_hints</a>(self, basedir):
<a name="l00590"></a>00590 <span class="stringliteral">"""Read the hint commands from the specified directory</span>
<a name="l00591"></a>00591 <span class="stringliteral"> </span>
<a name="l00592"></a>00592 <span class="stringliteral"> The hint commands are read from the files contained by the `Hints'</span>
<a name="l00593"></a>00593 <span class="stringliteral"> directory within the directory specified as `basedir' parameter. </span>
<a name="l00594"></a>00594 <span class="stringliteral"> The name of the files has to be the same of the authorized users</span>
<a name="l00595"></a>00595 <span class="stringliteral"> for the hints.</span>
<a name="l00596"></a>00596 <span class="stringliteral"> </span>
<a name="l00597"></a>00597 <span class="stringliteral"> The file contains rows with the format:</span>
<a name="l00598"></a>00598 <span class="stringliteral"></span>
<a name="l00599"></a>00599 <span class="stringliteral"> &lt;command&gt; &lt;package-name&gt;[/&lt;version&gt;]</span>
<a name="l00600"></a>00600 <span class="stringliteral"></span>
<a name="l00601"></a>00601 <span class="stringliteral"> The method returns a dictionary where the key is the command, and</span>
<a name="l00602"></a>00602 <span class="stringliteral"> the value is the list of affected packages.</span>
<a name="l00603"></a>00603 <span class="stringliteral"> """</span>
<a name="l00604"></a>00604 hints = dict([(k,[]) <span class="keywordflow">for</span> k <span class="keywordflow">in</span> self.<a class="code" href="classbritney_1_1Britney.html#a088d6fd96963f87f88c9c40cda10bfa">HINTS_ALL</a>])
<a name="l00605"></a>00605
<a name="l00606"></a>00606 <span class="keywordflow">for</span> who <span class="keywordflow">in</span> self.HINTS.keys():
<a name="l00607"></a>00607 filename = os.path.join(basedir, <span class="stringliteral">"Hints"</span>, who)
<a name="l00608"></a>00608 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Loading hints list from %s"</span> % filename)
<a name="l00609"></a>00609 <span class="keywordflow">for</span> line <span class="keywordflow">in</span> open(filename):
<a name="l00610"></a>00610 line = line.strip()
<a name="l00611"></a>00611 <span class="keywordflow">if</span> line == <span class="stringliteral">""</span>: <span class="keywordflow">continue</span>
<a name="l00612"></a>00612 l = line.split()
<a name="l00613"></a>00613 <span class="keywordflow">if</span> l[0] == <span class="stringliteral">'finished'</span>:
<a name="l00614"></a>00614 <span class="keywordflow">break</span>
<a name="l00615"></a>00615 <span class="keywordflow">elif</span> l[0] <span class="keywordflow">not</span> <span class="keywordflow">in</span> self.HINTS[who]:
<a name="l00616"></a>00616 <span class="keywordflow">continue</span>
<a name="l00617"></a>00617 <span class="keywordflow">elif</span> l[0] <span class="keywordflow">in</span> [<span class="stringliteral">"easy"</span>, <span class="stringliteral">"hint"</span>, <span class="stringliteral">"force-hint"</span>]:
<a name="l00618"></a>00618 hints[l[0]].append((who, [k.split(<span class="stringliteral">"/"</span>) <span class="keywordflow">for</span> k <span class="keywordflow">in</span> l <span class="keywordflow">if</span> <span class="stringliteral">"/"</span> <span class="keywordflow">in</span> k]))
<a name="l00619"></a>00619 <span class="keywordflow">elif</span> l[0] <span class="keywordflow">in</span> [<span class="stringliteral">"block-all"</span>]:
<a name="l00620"></a>00620 hints[l[0]].extend([(y, who) <span class="keywordflow">for</span> y <span class="keywordflow">in</span> l[1:]])
<a name="l00621"></a>00621 <span class="keywordflow">elif</span> l[0] <span class="keywordflow">in</span> [<span class="stringliteral">"block"</span>]:
<a name="l00622"></a>00622 hints[l[0]].extend([(y, who) <span class="keywordflow">for</span> y <span class="keywordflow">in</span> l[1:]])
<a name="l00623"></a>00623 <span class="keywordflow">elif</span> l[0] <span class="keywordflow">in</span> [<span class="stringliteral">"remove"</span>, <span class="stringliteral">"approve"</span>, <span class="stringliteral">"unblock"</span>, <span class="stringliteral">"force"</span>, <span class="stringliteral">"urgent"</span>]:
<a name="l00624"></a>00624 hints[l[0]].extend([(k.split(<span class="stringliteral">"/"</span>)[0], (k.split(<span class="stringliteral">"/"</span>)[1],who) ) <span class="keywordflow">for</span> k <span class="keywordflow">in</span> l <span class="keywordflow">if</span> <span class="stringliteral">"/"</span> <span class="keywordflow">in</span> k])
<a name="l00625"></a>00625
<a name="l00626"></a>00626 <span class="keywordflow">for</span> x <span class="keywordflow">in</span> [<span class="stringliteral">"block"</span>, <span class="stringliteral">"block-all"</span>, <span class="stringliteral">"unblock"</span>, <span class="stringliteral">"force"</span>, <span class="stringliteral">"urgent"</span>, <span class="stringliteral">"remove"</span>]:
<a name="l00627"></a>00627 z = {}
<a name="l00628"></a>00628 <span class="keywordflow">for</span> a, b <span class="keywordflow">in</span> hints[x]:
<a name="l00629"></a>00629 <span class="keywordflow">if</span> z.has_key(a):
<a name="l00630"></a><a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">00630</a> self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Overriding %s[%s] = %s with %s"</span> % (x, a, z[a], b), type=<span class="stringliteral">"W"</span>)
<a name="l00631"></a>00631 z[a] = b
<a name="l00632"></a>00632 hints[x] = z
<a name="l00633"></a>00633
<a name="l00634"></a>00634 <span class="keywordflow">return</span> hints
<a name="l00635"></a>00635
<a name="l00636"></a>00636 <span class="comment"># Utility methods for package analisys</span>
<a name="l00637"></a>00637 <span class="comment"># ------------------------------------</span>
<a name="l00638"></a>00638
<a name="l00639"></a>00639 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(self, sv1, sv2):
<a name="l00640"></a>00640 <span class="stringliteral">"""Check if two version numbers are built from the same source</span>
<a name="l00641"></a>00641 <span class="stringliteral"></span>
<a name="l00642"></a>00642 <span class="stringliteral"> This method returns a boolean value which is true if the two</span>
<a name="l00643"></a>00643 <span class="stringliteral"> version numbers specified as parameters are built from the same</span>
<a name="l00644"></a>00644 <span class="stringliteral"> source. The main use of this code is to detect binary-NMU.</span>
<a name="l00645"></a>00645 <span class="stringliteral"> """</span>
<a name="l00646"></a>00646 <span class="keywordflow">if</span> sv1 == sv2:
<a name="l00647"></a>00647 <span class="keywordflow">return</span> 1
<a name="l00648"></a>00648
<a name="l00649"></a>00649 m = re.match(<span class="stringliteral">r'^(.*)\+b\d+$'</span>, sv1)
<a name="l00650"></a>00650 <span class="keywordflow">if</span> m: sv1 = m.group(1)
<a name="l00651"></a>00651 m = re.match(<span class="stringliteral">r'^(.*)\+b\d+$'</span>, sv2)
<a name="l00652"></a>00652 <span class="keywordflow">if</span> m: sv2 = m.group(1)
<a name="l00653"></a>00653
<a name="l00654"></a>00654 <span class="keywordflow">if</span> sv1 == sv2:
<a name="l00655"></a>00655 <span class="keywordflow">return</span> 1
<a name="l00656"></a>00656
<a name="l00657"></a>00657 <span class="keywordflow">if</span> re.search(<span class="stringliteral">"-"</span>, sv1) <span class="keywordflow">or</span> re.search(<span class="stringliteral">"-"</span>, sv2):
<a name="l00658"></a>00658 m = re.match(<span class="stringliteral">r'^(.*-[^.]+)\.0\.\d+$'</span>, sv1)
<a name="l00659"></a>00659 <span class="keywordflow">if</span> m: sv1 = m.group(1)
<a name="l00660"></a>00660 m = re.match(<span class="stringliteral">r'^(.*-[^.]+\.[^.]+)\.\d+$'</span>, sv1)
<a name="l00661"></a>00661 <span class="keywordflow">if</span> m: sv1 = m.group(1)
<a name="l00662"></a>00662
<a name="l00663"></a>00663 m = re.match(<span class="stringliteral">r'^(.*-[^.]+)\.0\.\d+$'</span>, sv2)
<a name="l00664"></a>00664 <span class="keywordflow">if</span> m: sv2 = m.group(1)
<a name="l00665"></a>00665 m = re.match(<span class="stringliteral">r'^(.*-[^.]+\.[^.]+)\.\d+$'</span>, sv2)
<a name="l00666"></a>00666 <span class="keywordflow">if</span> m: sv2 = m.group(1)
<a name="l00667"></a>00667
<a name="l00668"></a>00668 <span class="keywordflow">return</span> (sv1 == sv2)
<a name="l00669"></a><a class="code" href="classbritney_1_1Britney.html#5461f49e3e75a251ebedfd37d2a5ff0c">00669</a> <span class="keywordflow">else</span>:
<a name="l00670"></a>00670 m = re.match(<span class="stringliteral">r'^([^-]+)\.0\.\d+$'</span>, sv1)
<a name="l00671"></a>00671 <span class="keywordflow">if</span> m <span class="keywordflow">and</span> sv2 == m.group(1): <span class="keywordflow">return</span> 1
<a name="l00672"></a>00672
<a name="l00673"></a>00673 m = re.match(<span class="stringliteral">r'^([^-]+)\.0\.\d+$'</span>, sv2)
<a name="l00674"></a>00674 <span class="keywordflow">if</span> m <span class="keywordflow">and</span> sv1 == m.group(1): <span class="keywordflow">return</span> 1
<a name="l00675"></a>00675
<a name="l00676"></a>00676 <span class="keywordflow">return</span> 0
<a name="l00677"></a>00677
<a name="l00678"></a>00678 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#5461f49e3e75a251ebedfd37d2a5ff0c">get_dependency_solvers</a>(self, block, arch, distribution, excluded=[]):
<a name="l00679"></a>00679 <span class="stringliteral">"""Find the packages which satisfy a dependency block</span>
<a name="l00680"></a>00680 <span class="stringliteral"></span>
<a name="l00681"></a>00681 <span class="stringliteral"> This method returns the list of packages which satisfy a dependency</span>
<a name="l00682"></a>00682 <span class="stringliteral"> block (as returned by apt_pkg.ParseDepends) for the given architecture</span>
<a name="l00683"></a>00683 <span class="stringliteral"> and distribution.</span>
<a name="l00684"></a>00684 <span class="stringliteral"></span>
<a name="l00685"></a>00685 <span class="stringliteral"> It returns a tuple with two items: the first is a boolean which is</span>
<a name="l00686"></a>00686 <span class="stringliteral"> True if the dependency is satisfied, the second is the list of the</span>
<a name="l00687"></a>00687 <span class="stringliteral"> solving packages.</span>
<a name="l00688"></a>00688 <span class="stringliteral"> """</span>
<a name="l00689"></a>00689
<a name="l00690"></a>00690 packages = []
<a name="l00691"></a>00691
<a name="l00692"></a>00692 <span class="comment"># for every package, version and operation in the block</span>
<a name="l00693"></a>00693 <span class="keywordflow">for</span> name, version, op <span class="keywordflow">in</span> block:
<a name="l00694"></a>00694 <span class="comment"># look for the package in unstable</span>
<a name="l00695"></a>00695 <span class="keywordflow">if</span> name <span class="keywordflow">in</span> self.binaries[distribution][arch][0] <span class="keywordflow">and</span> name <span class="keywordflow">not</span> <span class="keywordflow">in</span> excluded:
<a name="l00696"></a>00696 package = self.binaries[distribution][arch][0][name]
<a name="l00697"></a>00697 <span class="comment"># check the versioned dependency (if present)</span>
<a name="l00698"></a>00698 <span class="keywordflow">if</span> op == <span class="stringliteral">''</span> <span class="keywordflow">and</span> version == <span class="stringliteral">''</span> <span class="keywordflow">or</span> apt_pkg.CheckDep(package[<span class="stringliteral">'version'</span>], op, version):
<a name="l00699"></a>00699 packages.append(name)
<a name="l00700"></a>00700
<a name="l00701"></a>00701 <span class="comment"># look for the package in the virtual packages list</span>
<a name="l00702"></a>00702 <span class="keywordflow">if</span> name <span class="keywordflow">in</span> self.binaries[distribution][arch][1]:
<a name="l00703"></a>00703 <span class="comment"># loop on the list of packages which provides it</span>
<a name="l00704"></a>00704 <span class="keywordflow">for</span> prov <span class="keywordflow">in</span> self.binaries[distribution][arch][1][name]:
<a name="l00705"></a>00705 <span class="keywordflow">if</span> prov <span class="keywordflow">in</span> excluded <span class="keywordflow">or</span> \
<a name="l00706"></a>00706 <span class="keywordflow">not</span> self.binaries[distribution][arch][0].has_key(prov): <span class="keywordflow">continue</span>
<a name="l00707"></a>00707 package = self.binaries[distribution][arch][0][prov]
<a name="l00708"></a>00708 <span class="comment"># check the versioned dependency (if present)</span>
<a name="l00709"></a><a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">00709</a> <span class="comment"># TODO: this is forbidden by the debian policy, which says that versioned</span>
<a name="l00710"></a>00710 <span class="comment"># dependencies on virtual packages are never satisfied. The old britney</span>
<a name="l00711"></a>00711 <span class="comment"># does it and we have to go with it, but at least a warning should be raised.</span>
<a name="l00712"></a>00712 <span class="keywordflow">if</span> op == <span class="stringliteral">''</span> <span class="keywordflow">and</span> version == <span class="stringliteral">''</span> <span class="keywordflow">or</span> apt_pkg.CheckDep(package[<span class="stringliteral">'version'</span>], op, version):
<a name="l00713"></a>00713 packages.append(prov)
<a name="l00714"></a>00714 <span class="keywordflow">break</span>
<a name="l00715"></a>00715
<a name="l00716"></a>00716 <span class="keywordflow">return</span> (len(packages) &gt; 0, packages)
<a name="l00717"></a>00717
<a name="l00718"></a>00718 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a>(self, pkg, src, arch, suite, excuse=None, excluded=[]):
<a name="l00719"></a>00719 <span class="stringliteral">"""Find unsatisfied dependencies for a binary package</span>
<a name="l00720"></a>00720 <span class="stringliteral"></span>
<a name="l00721"></a>00721 <span class="stringliteral"> This method analyzes the dependencies of the binary package specified</span>
<a name="l00722"></a>00722 <span class="stringliteral"> by the parameter `pkg', built from the source package `src', for the</span>
<a name="l00723"></a>00723 <span class="stringliteral"> architecture `arch' within the suite `suite'. If the dependency can't</span>
<a name="l00724"></a>00724 <span class="stringliteral"> be satisfied in testing and/or unstable, it updates the excuse passed</span>
<a name="l00725"></a>00725 <span class="stringliteral"> as parameter.</span>
<a name="l00726"></a>00726 <span class="stringliteral"></span>
<a name="l00727"></a>00727 <span class="stringliteral"> The dependency fields checked are Pre-Depends and Depends.</span>
<a name="l00728"></a>00728 <span class="stringliteral"> """</span>
<a name="l00729"></a>00729 <span class="comment"># retrieve the binary package from the specified suite and arch</span>
<a name="l00730"></a>00730 binary_u = self.binaries[suite][arch][0][pkg]
<a name="l00731"></a>00731
<a name="l00732"></a>00732 <span class="comment"># analyze the dependency fields (if present)</span>
<a name="l00733"></a>00733 <span class="keywordflow">for</span> type <span class="keywordflow">in</span> (<span class="stringliteral">'Pre-Depends'</span>, <span class="stringliteral">'Depends'</span>):
<a name="l00734"></a>00734 type_key = type.lower()
<a name="l00735"></a>00735 <span class="keywordflow">if</span> <span class="keywordflow">not</span> binary_u.has_key(type_key):
<a name="l00736"></a>00736 <span class="keywordflow">continue</span>
<a name="l00737"></a>00737
<a name="l00738"></a>00738 <span class="comment"># this list will contain the packages that satisfy the dependency</span>
<a name="l00739"></a>00739 packages = []
<a name="l00740"></a>00740
<a name="l00741"></a>00741 <span class="comment"># for every block of dependency (which is formed as conjunction of disconjunction)</span>
<a name="l00742"></a>00742 <span class="keywordflow">for</span> block, block_txt <span class="keywordflow">in</span> zip(apt_pkg.ParseDepends(binary_u[type_key]), binary_u[type_key].split(<span class="stringliteral">','</span>)):
<a name="l00743"></a>00743 <span class="comment"># if the block is satisfied in testing, then skip the block</span>
<a name="l00744"></a>00744 solved, packages = self.<a class="code" href="classbritney_1_1Britney.html#5461f49e3e75a251ebedfd37d2a5ff0c">get_dependency_solvers</a>(block, arch, <span class="stringliteral">'testing'</span>, excluded)
<a name="l00745"></a>00745 <span class="keywordflow">if</span> solved: <span class="keywordflow">continue</span>
<a name="l00746"></a>00746 <span class="keywordflow">elif</span> excuse == <span class="keywordtype">None</span>:
<a name="l00747"></a>00747 <span class="keywordflow">return</span> <span class="keyword">False</span>
<a name="l00748"></a>00748
<a name="l00749"></a>00749 <span class="comment"># check if the block can be satisfied in unstable, and list the solving packages</span>
<a name="l00750"></a>00750 solved, packages = self.<a class="code" href="classbritney_1_1Britney.html#5461f49e3e75a251ebedfd37d2a5ff0c">get_dependency_solvers</a>(block, arch, suite)
<a name="l00751"></a>00751 packages = [self.binaries[suite][arch][0][p][<span class="stringliteral">'source'</span>] <span class="keywordflow">for</span> p <span class="keywordflow">in</span> packages]
<a name="l00752"></a>00752
<a name="l00753"></a>00753 <span class="comment"># if the dependency can be satisfied by the same source package, skip the block:</span>
<a name="l00754"></a>00754 <span class="comment"># obviously both binary packages will enter testing togheter</span>
<a name="l00755"></a>00755 <span class="keywordflow">if</span> src <span class="keywordflow">in</span> packages: <span class="keywordflow">continue</span>
<a name="l00756"></a>00756
<a name="l00757"></a>00757 <span class="comment"># if no package can satisfy the dependency, add this information to the excuse</span>
<a name="l00758"></a>00758 <span class="keywordflow">if</span> len(packages) == 0:
<a name="l00759"></a>00759 excuse.addhtml(<span class="stringliteral">"%s/%s unsatisfiable %s: %s"</span> % (pkg, arch, type, block_txt.strip()))
<a name="l00760"></a>00760
<a name="l00761"></a>00761 <span class="comment"># for the solving packages, update the excuse to add the dependencies</span>
<a name="l00762"></a>00762 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> packages:
<a name="l00763"></a>00763 <span class="keywordflow">if</span> arch <span class="keywordflow">not</span> <span class="keywordflow">in</span> self.options.break_arches.split():
<a name="l00764"></a>00764 excuse.add_dep(p)
<a name="l00765"></a><a class="code" href="classbritney_1_1Britney.html#f8a6c9adbdec7a5a982dd2b74febcc08">00765</a> <span class="keywordflow">else</span>:
<a name="l00766"></a>00766 excuse.add_break_dep(p, arch)
<a name="l00767"></a>00767
<a name="l00768"></a>00768 <span class="comment"># otherwise, the package is installable</span>
<a name="l00769"></a>00769 <span class="keywordflow">return</span> <span class="keyword">True</span>
<a name="l00770"></a>00770
<a name="l00771"></a>00771 <span class="comment"># Package analisys methods</span>
<a name="l00772"></a>00772 <span class="comment"># ------------------------</span>
<a name="l00773"></a>00773
<a name="l00774"></a>00774 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#f8a6c9adbdec7a5a982dd2b74febcc08">should_remove_source</a>(self, pkg):
<a name="l00775"></a>00775 <span class="stringliteral">"""Check if a source package should be removed from testing</span>
<a name="l00776"></a>00776 <span class="stringliteral"> </span>
<a name="l00777"></a>00777 <span class="stringliteral"> This method checks if a source package should be removed from the</span>
<a name="l00778"></a>00778 <span class="stringliteral"> testing distribution; this happen if the source package is not</span>
<a name="l00779"></a>00779 <span class="stringliteral"> present in the unstable distribution anymore.</span>
<a name="l00780"></a>00780 <span class="stringliteral"></span>
<a name="l00781"></a>00781 <span class="stringliteral"> It returns True if the package can be removed, False otherwise.</span>
<a name="l00782"></a>00782 <span class="stringliteral"> In the former case, a new excuse is appended to the the object</span>
<a name="l00783"></a>00783 <span class="stringliteral"> attribute excuses.</span>
<a name="l00784"></a>00784 <span class="stringliteral"> """</span>
<a name="l00785"></a>00785 <span class="comment"># if the soruce package is available in unstable, then do nothing</span>
<a name="l00786"></a>00786 <span class="keywordflow">if</span> self.sources[<span class="stringliteral">'unstable'</span>].has_key(pkg):
<a name="l00787"></a>00787 <span class="keywordflow">return</span> <span class="keyword">False</span>
<a name="l00788"></a>00788 <span class="comment"># otherwise, add a new excuse for its removal and return True</span>
<a name="l00789"></a><a class="code" href="classbritney_1_1Britney.html#bd18d7acde434387e94344a39db5b0e5">00789</a> src = self.sources[<span class="stringliteral">'testing'</span>][pkg]
<a name="l00790"></a>00790 excuse = Excuse(<span class="stringliteral">"-"</span> + pkg)
<a name="l00791"></a>00791 excuse.set_vers(src[<span class="stringliteral">'version'</span>], <span class="keywordtype">None</span>)
<a name="l00792"></a>00792 src[<span class="stringliteral">'maintainer'</span>] <span class="keywordflow">and</span> excuse.set_maint(src[<span class="stringliteral">'maintainer'</span>].strip())
<a name="l00793"></a>00793 src[<span class="stringliteral">'section'</span>] <span class="keywordflow">and</span> excuse.set_section(src[<span class="stringliteral">'section'</span>].strip())
<a name="l00794"></a>00794 excuse.addhtml(<span class="stringliteral">"Valid candidate"</span>)
<a name="l00795"></a>00795 self.excuses.append(excuse)
<a name="l00796"></a>00796 <span class="keywordflow">return</span> <span class="keyword">True</span>
<a name="l00797"></a>00797
<a name="l00798"></a>00798 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#bd18d7acde434387e94344a39db5b0e5">should_upgrade_srcarch</a>(self, src, arch, suite):
<a name="l00799"></a>00799 <span class="stringliteral">"""Check if binary package should be upgraded</span>
<a name="l00800"></a>00800 <span class="stringliteral"></span>
<a name="l00801"></a>00801 <span class="stringliteral"> This method checks if a binary package should be upgraded; this can</span>
<a name="l00802"></a>00802 <span class="stringliteral"> happen also if the binary package is a binary-NMU for the given arch.</span>
<a name="l00803"></a>00803 <span class="stringliteral"> The analisys is performed for the source package specified by the</span>
<a name="l00804"></a>00804 <span class="stringliteral"> `src' parameter, checking the architecture `arch' for the distribution</span>
<a name="l00805"></a>00805 <span class="stringliteral"> `suite'.</span>
<a name="l00806"></a>00806 <span class="stringliteral"> </span>
<a name="l00807"></a>00807 <span class="stringliteral"> It returns False if the given package doesn't need to be upgraded,</span>
<a name="l00808"></a>00808 <span class="stringliteral"> True otherwise. In the former case, a new excuse is appended to</span>
<a name="l00809"></a>00809 <span class="stringliteral"> the the object attribute excuses.</span>
<a name="l00810"></a>00810 <span class="stringliteral"> """</span>
<a name="l00811"></a>00811 <span class="comment"># retrieve the source packages for testing and suite</span>
<a name="l00812"></a>00812 source_t = self.sources[<span class="stringliteral">'testing'</span>][src]
<a name="l00813"></a>00813 source_u = self.sources[suite][src]
<a name="l00814"></a>00814
<a name="l00815"></a>00815 <span class="comment"># build the common part of the excuse, which will be filled by the code below</span>
<a name="l00816"></a>00816 ref = <span class="stringliteral">"%s/%s%s"</span> % (src, arch, suite != <span class="stringliteral">'unstable'</span> <span class="keywordflow">and</span> <span class="stringliteral">"_"</span> + suite <span class="keywordflow">or</span> <span class="stringliteral">""</span>)
<a name="l00817"></a>00817 excuse = Excuse(ref)
<a name="l00818"></a>00818 excuse.set_vers(source_t[<span class="stringliteral">'version'</span>], source_t[<span class="stringliteral">'version'</span>])
<a name="l00819"></a>00819 source_u[<span class="stringliteral">'maintainer'</span>] <span class="keywordflow">and</span> excuse.set_maint(source_u[<span class="stringliteral">'maintainer'</span>].strip())
<a name="l00820"></a>00820 source_u[<span class="stringliteral">'section'</span>] <span class="keywordflow">and</span> excuse.set_section(source_u[<span class="stringliteral">'section'</span>].strip())
<a name="l00821"></a>00821
<a name="l00822"></a>00822 <span class="comment"># if there is a `remove' hint and the requested version is the same of the</span>
<a name="l00823"></a>00823 <span class="comment"># version in testing, then stop here and return False</span>
<a name="l00824"></a>00824 <span class="keywordflow">if</span> self.hints[<span class="stringliteral">"remove"</span>].has_key(src) <span class="keywordflow">and</span> \
<a name="l00825"></a>00825 self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_t[<span class="stringliteral">'version'</span>], self.hints[<span class="stringliteral">"remove"</span>][src][0]):
<a name="l00826"></a>00826 excuse.addhtml(<span class="stringliteral">"Removal request by %s"</span> % (self.hints[<span class="stringliteral">"remove"</span>][src][1]))
<a name="l00827"></a>00827 excuse.addhtml(<span class="stringliteral">"Trying to remove package, not update it"</span>)
<a name="l00828"></a>00828 excuse.addhtml(<span class="stringliteral">"Not considered"</span>)
<a name="l00829"></a>00829 self.excuses.append(excuse)
<a name="l00830"></a>00830 <span class="keywordflow">return</span> <span class="keyword">False</span>
<a name="l00831"></a>00831
<a name="l00832"></a>00832 <span class="comment"># the starting point is that there is nothing wrong and nothing worth doing</span>
<a name="l00833"></a>00833 anywrongver = <span class="keyword">False</span>
<a name="l00834"></a>00834 anyworthdoing = <span class="keyword">False</span>
<a name="l00835"></a>00835
<a name="l00836"></a>00836 <span class="comment"># for every binary package produced by this source in unstable for this architecture</span>
<a name="l00837"></a>00837 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> sorted(filter(<span class="keyword">lambda</span> x: x.endswith(<span class="stringliteral">"/"</span> + arch), source_u[<span class="stringliteral">'binaries'</span>])):
<a name="l00838"></a>00838 pkg_name = pkg.split(<span class="stringliteral">"/"</span>)[0]
<a name="l00839"></a>00839
<a name="l00840"></a>00840 <span class="comment"># retrieve the testing (if present) and unstable corresponding binary packages</span>
<a name="l00841"></a>00841 binary_t = pkg <span class="keywordflow">in</span> source_t[<span class="stringliteral">'binaries'</span>] <span class="keywordflow">and</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][pkg_name] <span class="keywordflow">or</span> <span class="keywordtype">None</span>
<a name="l00842"></a>00842 binary_u = self.binaries[suite][arch][0][pkg_name]
<a name="l00843"></a>00843
<a name="l00844"></a>00844 <span class="comment"># this is the source version for the new binary package</span>
<a name="l00845"></a>00845 pkgsv = self.binaries[suite][arch][0][pkg_name][<span class="stringliteral">'source-ver'</span>]
<a name="l00846"></a>00846
<a name="l00847"></a>00847 <span class="comment"># if the new binary package is architecture-independent, then skip it</span>
<a name="l00848"></a>00848 <span class="keywordflow">if</span> binary_u[<span class="stringliteral">'architecture'</span>] == <span class="stringliteral">'all'</span>:
<a name="l00849"></a>00849 excuse.addhtml(<span class="stringliteral">"Ignoring %s %s (from %s) as it is arch: all"</span> % (pkg_name, binary_u[<span class="stringliteral">'version'</span>], pkgsv))
<a name="l00850"></a>00850 <span class="keywordflow">continue</span>
<a name="l00851"></a>00851
<a name="l00852"></a>00852 <span class="comment"># if the new binary package is not from the same source as the testing one, then skip it</span>
<a name="l00853"></a>00853 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_t[<span class="stringliteral">'version'</span>], pkgsv):
<a name="l00854"></a>00854 anywrongver = <span class="keyword">True</span>
<a name="l00855"></a>00855 excuse.addhtml(<span class="stringliteral">"From wrong source: %s %s (%s not %s)"</span> % (pkg_name, binary_u[<span class="stringliteral">'version'</span>], pkgsv, source_t[<span class="stringliteral">'version'</span>]))
<a name="l00856"></a>00856 <span class="keywordflow">break</span>
<a name="l00857"></a>00857
<a name="l00858"></a>00858 <span class="comment"># find unsatisfied dependencies for the new binary package</span>
<a name="l00859"></a>00859 self.<a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a>(pkg_name, src, arch, suite, excuse)
<a name="l00860"></a>00860
<a name="l00861"></a>00861 <span class="comment"># if the binary is not present in testing, then it is a new binary;</span>
<a name="l00862"></a>00862 <span class="comment"># in this case, there is something worth doing</span>
<a name="l00863"></a>00863 <span class="keywordflow">if</span> <span class="keywordflow">not</span> binary_t:
<a name="l00864"></a>00864 excuse.addhtml(<span class="stringliteral">"New binary: %s (%s)"</span> % (pkg_name, binary_u[<span class="stringliteral">'version'</span>]))
<a name="l00865"></a>00865 anyworthdoing = <span class="keyword">True</span>
<a name="l00866"></a>00866 <span class="keywordflow">continue</span>
<a name="l00867"></a>00867
<a name="l00868"></a>00868 <span class="comment"># at this point, the binary package is present in testing, so we can compare</span>
<a name="l00869"></a>00869 <span class="comment"># the versions of the packages ...</span>
<a name="l00870"></a>00870 vcompare = apt_pkg.VersionCompare(binary_t[<span class="stringliteral">'version'</span>], binary_u[<span class="stringliteral">'version'</span>])
<a name="l00871"></a>00871
<a name="l00872"></a>00872 <span class="comment"># ... if updating would mean downgrading, then stop here: there is something wrong</span>
<a name="l00873"></a>00873 <span class="keywordflow">if</span> vcompare &gt; 0:
<a name="l00874"></a>00874 anywrongver = <span class="keyword">True</span>
<a name="l00875"></a>00875 excuse.addhtml(<span class="stringliteral">"Not downgrading: %s (%s to %s)"</span> % (pkg_name, binary_t[<span class="stringliteral">'version'</span>], binary_u[<span class="stringliteral">'version'</span>]))
<a name="l00876"></a>00876 <span class="keywordflow">break</span>
<a name="l00877"></a>00877 <span class="comment"># ... if updating would mean upgrading, then there is something worth doing</span>
<a name="l00878"></a>00878 <span class="keywordflow">elif</span> vcompare &lt; 0:
<a name="l00879"></a>00879 excuse.addhtml(<span class="stringliteral">"Updated binary: %s (%s to %s)"</span> % (pkg_name, binary_t[<span class="stringliteral">'version'</span>], binary_u[<span class="stringliteral">'version'</span>]))
<a name="l00880"></a>00880 anyworthdoing = <span class="keyword">True</span>
<a name="l00881"></a>00881
<a name="l00882"></a>00882 <span class="comment"># if there is nothing wrong and there is something worth doing or the source</span>
<a name="l00883"></a>00883 <span class="comment"># package is not fake, then check what packages shuold be removed</span>
<a name="l00884"></a>00884 <span class="keywordflow">if</span> <span class="keywordflow">not</span> anywrongver <span class="keywordflow">and</span> (anyworthdoing <span class="keywordflow">or</span> self.sources[suite][src].has_key(<span class="stringliteral">'fake'</span>)):
<a name="l00885"></a>00885 srcv = self.sources[suite][src][<span class="stringliteral">'version'</span>]
<a name="l00886"></a>00886 ssrc = self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_t[<span class="stringliteral">'version'</span>], srcv)
<a name="l00887"></a>00887 <span class="comment"># for every binary package produced by this source in testing for this architecture</span>
<a name="l00888"></a>00888 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> sorted([x.split(<span class="stringliteral">"/"</span>)[0] <span class="keywordflow">for</span> x <span class="keywordflow">in</span> self.sources[<span class="stringliteral">'testing'</span>][src][<span class="stringliteral">'binaries'</span>] <span class="keywordflow">if</span> x.endswith(<span class="stringliteral">"/"</span>+arch)]):
<a name="l00889"></a>00889 <span class="comment"># if the package is architecture-independent, then ignore it</span>
<a name="l00890"></a>00890 <span class="keywordflow">if</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][pkg][<span class="stringliteral">'architecture'</span>] == <span class="stringliteral">'all'</span>:
<a name="l00891"></a>00891 excuse.addhtml(<span class="stringliteral">"Ignoring removal of %s as it is arch: all"</span> % (pkg))
<a name="l00892"></a>00892 <span class="keywordflow">continue</span>
<a name="l00893"></a>00893 <span class="comment"># if the package is not produced by the new source package, then remove it from testing</span>
<a name="l00894"></a>00894 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.binaries[suite][arch][0].has_key(pkg):
<a name="l00895"></a>00895 tpkgv = self.binaries[<span class="stringliteral">'testing'</span>][arch][0][pkg][<span class="stringliteral">'version'</span>]
<a name="l00896"></a>00896 excuse.addhtml(<span class="stringliteral">"Removed binary: %s %s"</span> % (pkg, tpkgv))
<a name="l00897"></a>00897 <span class="keywordflow">if</span> ssrc: anyworthdoing = <span class="keyword">True</span>
<a name="l00898"></a>00898
<a name="l00899"></a>00899 <span class="comment"># if there is nothing wrong and there is something worth doing, this is valid candidate</span>
<a name="l00900"></a>00900 <span class="keywordflow">if</span> <span class="keywordflow">not</span> anywrongver <span class="keywordflow">and</span> anyworthdoing:
<a name="l00901"></a>00901 excuse.addhtml(<span class="stringliteral">"Valid candidate"</span>)
<a name="l00902"></a>00902 self.excuses.append(excuse)
<a name="l00903"></a><a class="code" href="classbritney_1_1Britney.html#94785175a85f44b1afaf3add167a211f">00903</a> <span class="keywordflow">return</span> <span class="keyword">True</span>
<a name="l00904"></a>00904 <span class="comment"># else if there is something worth doing (but something wrong, too) this package won't be considered</span>
<a name="l00905"></a>00905 <span class="keywordflow">elif</span> anyworthdoing:
<a name="l00906"></a>00906 excuse.addhtml(<span class="stringliteral">"Not considered"</span>)
<a name="l00907"></a>00907 self.excuses.append(excuse)
<a name="l00908"></a>00908
<a name="l00909"></a>00909 <span class="comment"># otherwise, return False</span>
<a name="l00910"></a>00910 <span class="keywordflow">return</span> <span class="keyword">False</span>
<a name="l00911"></a>00911
<a name="l00912"></a>00912 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#94785175a85f44b1afaf3add167a211f">should_upgrade_src</a>(self, src, suite):
<a name="l00913"></a>00913 <span class="stringliteral">"""Check if source package should be upgraded</span>
<a name="l00914"></a>00914 <span class="stringliteral"></span>
<a name="l00915"></a>00915 <span class="stringliteral"> This method checks if a source package should be upgraded. The analisys</span>
<a name="l00916"></a>00916 <span class="stringliteral"> is performed for the source package specified by the `src' parameter, </span>
<a name="l00917"></a>00917 <span class="stringliteral"> checking the architecture `arch' for the distribution `suite'.</span>
<a name="l00918"></a>00918 <span class="stringliteral"> </span>
<a name="l00919"></a>00919 <span class="stringliteral"> It returns False if the given package doesn't need to be upgraded,</span>
<a name="l00920"></a>00920 <span class="stringliteral"> True otherwise. In the former case, a new excuse is appended to</span>
<a name="l00921"></a>00921 <span class="stringliteral"> the the object attribute excuses.</span>
<a name="l00922"></a>00922 <span class="stringliteral"> """</span>
<a name="l00923"></a>00923
<a name="l00924"></a>00924 <span class="comment"># retrieve the source packages for testing (if available) and suite</span>
<a name="l00925"></a>00925 source_u = self.sources[suite][src]
<a name="l00926"></a>00926 <span class="keywordflow">if</span> src <span class="keywordflow">in</span> self.sources[<span class="stringliteral">'testing'</span>]:
<a name="l00927"></a>00927 source_t = self.sources[<span class="stringliteral">'testing'</span>][src]
<a name="l00928"></a>00928 <span class="comment"># if testing and unstable have the same version, then this is a candidate for binary-NMUs only</span>
<a name="l00929"></a>00929 <span class="keywordflow">if</span> apt_pkg.VersionCompare(source_t[<span class="stringliteral">'version'</span>], source_u[<span class="stringliteral">'version'</span>]) == 0:
<a name="l00930"></a>00930 <span class="keywordflow">return</span> <span class="keyword">False</span>
<a name="l00931"></a>00931 <span class="keywordflow">else</span>:
<a name="l00932"></a>00932 source_t = <span class="keywordtype">None</span>
<a name="l00933"></a>00933
<a name="l00934"></a>00934 <span class="comment"># build the common part of the excuse, which will be filled by the code below</span>
<a name="l00935"></a>00935 ref = <span class="stringliteral">"%s%s"</span> % (src, suite != <span class="stringliteral">'unstable'</span> <span class="keywordflow">and</span> <span class="stringliteral">"_"</span> + suite <span class="keywordflow">or</span> <span class="stringliteral">""</span>)
<a name="l00936"></a>00936 excuse = Excuse(ref)
<a name="l00937"></a>00937 excuse.set_vers(source_t <span class="keywordflow">and</span> source_t[<span class="stringliteral">'version'</span>] <span class="keywordflow">or</span> <span class="keywordtype">None</span>, source_u[<span class="stringliteral">'version'</span>])
<a name="l00938"></a>00938 source_u[<span class="stringliteral">'maintainer'</span>] <span class="keywordflow">and</span> excuse.set_maint(source_u[<span class="stringliteral">'maintainer'</span>].strip())
<a name="l00939"></a>00939 source_u[<span class="stringliteral">'section'</span>] <span class="keywordflow">and</span> excuse.set_section(source_u[<span class="stringliteral">'section'</span>].strip())
<a name="l00940"></a>00940
<a name="l00941"></a>00941 <span class="comment"># the starting point is that we will update the candidate</span>
<a name="l00942"></a>00942 update_candidate = <span class="keyword">True</span>
<a name="l00943"></a>00943
<a name="l00944"></a>00944 <span class="comment"># if the version in unstable is older, then stop here with a warning in the excuse and return False</span>
<a name="l00945"></a>00945 <span class="keywordflow">if</span> source_t <span class="keywordflow">and</span> apt_pkg.VersionCompare(source_u[<span class="stringliteral">'version'</span>], source_t[<span class="stringliteral">'version'</span>]) &lt; 0:
<a name="l00946"></a>00946 excuse.addhtml(<span class="stringliteral">"ALERT: %s is newer in testing (%s %s)"</span> % (src, source_t[<span class="stringliteral">'version'</span>], source_u[<span class="stringliteral">'version'</span>]))
<a name="l00947"></a>00947 self.excuses.append(excuse)
<a name="l00948"></a>00948 <span class="keywordflow">return</span> <span class="keyword">False</span>
<a name="l00949"></a>00949
<a name="l00950"></a>00950 <span class="comment"># check if the source package really exists or if it is a fake one</span>
<a name="l00951"></a>00951 <span class="keywordflow">if</span> source_u.has_key(<span class="stringliteral">'fake'</span>):
<a name="l00952"></a>00952 excuse.addhtml(<span class="stringliteral">"%s source package doesn't exist"</span> % (src))
<a name="l00953"></a>00953 update_candidate = <span class="keyword">False</span>
<a name="l00954"></a>00954
<a name="l00955"></a>00955 <span class="comment"># retrieve the urgency for the upload, ignoring it if this is a NEW package (not present in testing)</span>
<a name="l00956"></a>00956 urgency = self.urgencies.get(src, self.options.default_urgency)
<a name="l00957"></a>00957 <span class="keywordflow">if</span> <span class="keywordflow">not</span> source_t <span class="keywordflow">and</span> urgency != self.options.default_urgency:
<a name="l00958"></a>00958 excuse.addhtml(<span class="stringliteral">"Ignoring %s urgency setting for NEW package"</span> % (urgency))
<a name="l00959"></a>00959 urgency = self.options.default_urgency
<a name="l00960"></a>00960
<a name="l00961"></a>00961 <span class="comment"># if there is a `remove' hint and the requested version is the same of the</span>
<a name="l00962"></a>00962 <span class="comment"># version in testing, then stop here and return False</span>
<a name="l00963"></a>00963 <span class="keywordflow">if</span> self.hints[<span class="stringliteral">"remove"</span>].has_key(src):
<a name="l00964"></a>00964 <span class="keywordflow">if</span> source_t <span class="keywordflow">and</span> self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_t[<span class="stringliteral">'version'</span>], self.hints[<span class="stringliteral">'remove'</span>][src][0]) <span class="keywordflow">or</span> \
<a name="l00965"></a>00965 self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_u[<span class="stringliteral">'version'</span>], self.hints[<span class="stringliteral">'remove'</span>][src][0]):
<a name="l00966"></a>00966 excuse.addhtml(<span class="stringliteral">"Removal request by %s"</span> % (self.hints[<span class="stringliteral">"remove"</span>][src][1]))
<a name="l00967"></a>00967 excuse.addhtml(<span class="stringliteral">"Trying to remove package, not update it"</span>)
<a name="l00968"></a>00968 update_candidate = <span class="keyword">False</span>
<a name="l00969"></a>00969
<a name="l00970"></a>00970 <span class="comment"># check if there is a `block' hint for this package or a `block-all source' hint</span>
<a name="l00971"></a>00971 blocked = <span class="keywordtype">None</span>
<a name="l00972"></a>00972 <span class="keywordflow">if</span> self.hints[<span class="stringliteral">"block"</span>].has_key(src):
<a name="l00973"></a>00973 blocked = self.hints[<span class="stringliteral">"block"</span>][src]
<a name="l00974"></a>00974 <span class="keywordflow">elif</span> self.hints[<span class="stringliteral">"block-all"</span>].has_key(<span class="stringliteral">"source"</span>):
<a name="l00975"></a>00975 blocked = self.hints[<span class="stringliteral">"block-all"</span>][<span class="stringliteral">"source"</span>]
<a name="l00976"></a>00976
<a name="l00977"></a>00977 <span class="comment"># if the source is blocked, then look for an `unblock' hint; the unblock request</span>
<a name="l00978"></a>00978 <span class="comment"># is processed only if the specified version is correct</span>
<a name="l00979"></a>00979 <span class="keywordflow">if</span> blocked:
<a name="l00980"></a>00980 unblock = self.hints[<span class="stringliteral">"unblock"</span>].get(src,(<span class="keywordtype">None</span>,<span class="keywordtype">None</span>))
<a name="l00981"></a>00981 <span class="keywordflow">if</span> unblock[0] != <span class="keywordtype">None</span>:
<a name="l00982"></a>00982 <span class="keywordflow">if</span> self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(unblock[0], source_u[<span class="stringliteral">'version'</span>]):
<a name="l00983"></a>00983 excuse.addhtml(<span class="stringliteral">"Ignoring request to block package by %s, due to unblock request by %s"</span> % (blocked, unblock[1]))
<a name="l00984"></a>00984 <span class="keywordflow">else</span>:
<a name="l00985"></a>00985 excuse.addhtml(<span class="stringliteral">"Unblock request by %s ignored due to version mismatch: %s"</span> % (unblock[1], unblock[0]))
<a name="l00986"></a>00986 <span class="keywordflow">else</span>:
<a name="l00987"></a>00987 excuse.addhtml(<span class="stringliteral">"Not touching package, as requested by %s (contact debian-release if update is needed)"</span> % (blocked))
<a name="l00988"></a>00988 update_candidate = <span class="keyword">False</span>
<a name="l00989"></a>00989
<a name="l00990"></a>00990 <span class="comment"># if the suite is unstable, then we have to check the urgency and the minimum days of</span>
<a name="l00991"></a>00991 <span class="comment"># permanence in unstable before updating testing; if the source package is too young,</span>
<a name="l00992"></a>00992 <span class="comment"># the check fails and we set update_candidate to False to block the update</span>
<a name="l00993"></a>00993 <span class="keywordflow">if</span> suite == <span class="stringliteral">'unstable'</span>:
<a name="l00994"></a>00994 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.dates.has_key(src):
<a name="l00995"></a>00995 self.dates[src] = (source_u[<span class="stringliteral">'version'</span>], self.date_now)
<a name="l00996"></a>00996 <span class="keywordflow">elif</span> <span class="keywordflow">not</span> self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(self.dates[src][0], source_u[<span class="stringliteral">'version'</span>]):
<a name="l00997"></a>00997 self.dates[src] = (source_u[<span class="stringliteral">'version'</span>], self.date_now)
<a name="l00998"></a>00998
<a name="l00999"></a>00999 days_old = self.date_now - self.dates[src][1]
<a name="l01000"></a>01000 min_days = self.MINDAYS[urgency]
<a name="l01001"></a>01001 excuse.setdaysold(days_old, min_days)
<a name="l01002"></a>01002 <span class="keywordflow">if</span> days_old &lt; min_days:
<a name="l01003"></a>01003 <span class="keywordflow">if</span> self.hints[<span class="stringliteral">"urgent"</span>].has_key(src) <span class="keywordflow">and</span> self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_u[<span class="stringliteral">'version'</span>], self.hints[<span class="stringliteral">"urgent"</span>][src][0]):
<a name="l01004"></a>01004 excuse.addhtml(<span class="stringliteral">"Too young, but urgency pushed by %s"</span> % (self.hints[<span class="stringliteral">"urgent"</span>][src][1]))
<a name="l01005"></a>01005 <span class="keywordflow">else</span>:
<a name="l01006"></a>01006 update_candidate = <span class="keyword">False</span>
<a name="l01007"></a>01007
<a name="l01008"></a>01008 <span class="comment"># at this point, we check what is the status of the builds on all the supported architectures</span>
<a name="l01009"></a>01009 <span class="comment"># to catch the out-of-date ones</span>
<a name="l01010"></a>01010 pkgs = {src: [<span class="stringliteral">"source"</span>]}
<a name="l01011"></a>01011 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l01012"></a>01012 oodbins = {}
<a name="l01013"></a>01013 <span class="comment"># for every binary package produced by this source in the suite for this architecture</span>
<a name="l01014"></a>01014 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> sorted([x.split(<span class="stringliteral">"/"</span>)[0] <span class="keywordflow">for</span> x <span class="keywordflow">in</span> self.sources[suite][src][<span class="stringliteral">'binaries'</span>] <span class="keywordflow">if</span> x.endswith(<span class="stringliteral">"/"</span>+arch)]):
<a name="l01015"></a>01015 <span class="keywordflow">if</span> <span class="keywordflow">not</span> pkgs.has_key(pkg): pkgs[pkg] = []
<a name="l01016"></a>01016 pkgs[pkg].append(arch)
<a name="l01017"></a>01017
<a name="l01018"></a>01018 <span class="comment"># retrieve the binary package and its source version</span>
<a name="l01019"></a>01019 binary_u = self.binaries[suite][arch][0][pkg]
<a name="l01020"></a>01020 pkgsv = binary_u[<span class="stringliteral">'source-ver'</span>]
<a name="l01021"></a>01021
<a name="l01022"></a>01022 <span class="comment"># if it wasn't builded by the same source, it is out-of-date</span>
<a name="l01023"></a>01023 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_u[<span class="stringliteral">'version'</span>], pkgsv):
<a name="l01024"></a>01024 <span class="keywordflow">if</span> <span class="keywordflow">not</span> oodbins.has_key(pkgsv):
<a name="l01025"></a>01025 oodbins[pkgsv] = []
<a name="l01026"></a>01026 oodbins[pkgsv].append(pkg)
<a name="l01027"></a>01027 <span class="keywordflow">continue</span>
<a name="l01028"></a>01028
<a name="l01029"></a>01029 <span class="comment"># if the package is architecture-dependent or the current arch is `nobreakall'</span>
<a name="l01030"></a>01030 <span class="comment"># find unsatisfied dependencies for the binary package</span>
<a name="l01031"></a>01031 <span class="keywordflow">if</span> binary_u[<span class="stringliteral">'architecture'</span>] != <span class="stringliteral">'all'</span> <span class="keywordflow">or</span> arch <span class="keywordflow">in</span> self.options.nobreakall_arches:
<a name="l01032"></a>01032 self.<a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a>(pkg, src, arch, suite, excuse)
<a name="l01033"></a>01033
<a name="l01034"></a>01034 <span class="comment"># if there are out-of-date packages, warn about them in the excuse and set update_candidate</span>
<a name="l01035"></a>01035 <span class="comment"># to False to block the update; if the architecture where the package is out-of-date is</span>
<a name="l01036"></a>01036 <span class="comment"># in the `fucked_arches' list, then do not block the update</span>
<a name="l01037"></a>01037 <span class="keywordflow">if</span> oodbins:
<a name="l01038"></a>01038 oodtxt = <span class="stringliteral">""</span>
<a name="l01039"></a>01039 <span class="keywordflow">for</span> v <span class="keywordflow">in</span> oodbins.keys():
<a name="l01040"></a>01040 <span class="keywordflow">if</span> oodtxt: oodtxt = oodtxt + <span class="stringliteral">"; "</span>
<a name="l01041"></a>01041 oodtxt = oodtxt + <span class="stringliteral">"%s (from &lt;a href=\"http://buildd.debian.org/build.php?"</span> \
<a name="l01042"></a>01042 <span class="stringliteral">"arch=%s&amp;pkg=%s&amp;ver=%s\" target=\"_blank\"&gt;%s&lt;/a&gt;)"</span> % \
<a name="l01043"></a>01043 (<span class="stringliteral">", "</span>.join(sorted(oodbins[v])), arch, src, v, v)
<a name="l01044"></a>01044 text = <span class="stringliteral">"out of date on &lt;a href=\"http://buildd.debian.org/build.php?"</span> \
<a name="l01045"></a>01045 <span class="stringliteral">"arch=%s&amp;pkg=%s&amp;ver=%s\" target=\"_blank\"&gt;%s&lt;/a&gt;: %s"</span> % \
<a name="l01046"></a>01046 (arch, src, source_u[<span class="stringliteral">'version'</span>], arch, oodtxt)
<a name="l01047"></a>01047
<a name="l01048"></a>01048 <span class="keywordflow">if</span> arch <span class="keywordflow">in</span> self.options.fucked_arches:
<a name="l01049"></a>01049 text = text + <span class="stringliteral">" (but %s isn't keeping up, so nevermind)"</span> % (arch)
<a name="l01050"></a>01050 <span class="keywordflow">else</span>:
<a name="l01051"></a>01051 update_candidate = <span class="keyword">False</span>
<a name="l01052"></a>01052
<a name="l01053"></a>01053 <span class="keywordflow">if</span> self.date_now != self.dates[src][1]:
<a name="l01054"></a>01054 excuse.addhtml(text)
<a name="l01055"></a>01055
<a name="l01056"></a>01056 <span class="comment"># if the source package has no binaries, set update_candidate to False to block the update</span>
<a name="l01057"></a>01057 <span class="keywordflow">if</span> len(self.sources[suite][src][<span class="stringliteral">'binaries'</span>]) == 0:
<a name="l01058"></a>01058 excuse.addhtml(<span class="stringliteral">"%s has no binaries on any arch"</span> % src)
<a name="l01059"></a>01059 update_candidate = <span class="keyword">False</span>
<a name="l01060"></a>01060
<a name="l01061"></a>01061 <span class="comment"># if the suite is unstable, then we have to check the release-critical bug counts before</span>
<a name="l01062"></a>01062 <span class="comment"># updating testing; if the unstable package have a RC bug count greater than the testing</span>
<a name="l01063"></a>01063 <span class="comment"># one, the check fails and we set update_candidate to False to block the update</span>
<a name="l01064"></a>01064 <span class="keywordflow">if</span> suite == <span class="stringliteral">'unstable'</span>:
<a name="l01065"></a>01065 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> pkgs.keys():
<a name="l01066"></a>01066 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.bugs[<span class="stringliteral">'testing'</span>].has_key(pkg):
<a name="l01067"></a>01067 self.bugs[<span class="stringliteral">'testing'</span>][pkg] = 0
<a name="l01068"></a>01068 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.bugs[<span class="stringliteral">'unstable'</span>].has_key(pkg):
<a name="l01069"></a>01069 self.bugs[<span class="stringliteral">'unstable'</span>][pkg] = 0
<a name="l01070"></a>01070
<a name="l01071"></a>01071 <span class="keywordflow">if</span> self.bugs[<span class="stringliteral">'unstable'</span>][pkg] &gt; self.bugs[<span class="stringliteral">'testing'</span>][pkg]:
<a name="l01072"></a>01072 excuse.addhtml(<span class="stringliteral">"%s (%s) is &lt;a href=\"http://bugs.debian.org/cgi-bin/pkgreport.cgi?"</span> \
<a name="l01073"></a>01073 <span class="stringliteral">"which=pkg&amp;data=%s&amp;sev-inc=critical&amp;sev-inc=grave&amp;sev-inc=serious\" "</span> \
<a name="l01074"></a>01074 <span class="stringliteral">"target=\"_blank\"&gt;buggy&lt;/a&gt;! (%d &gt; %d)"</span> % \
<a name="l01075"></a>01075 (pkg, <span class="stringliteral">", "</span>.join(pkgs[pkg]), pkg, self.bugs[<span class="stringliteral">'unstable'</span>][pkg], self.bugs[<span class="stringliteral">'testing'</span>][pkg]))
<a name="l01076"></a>01076 update_candidate = <span class="keyword">False</span>
<a name="l01077"></a>01077 <span class="keywordflow">elif</span> self.bugs[<span class="stringliteral">'unstable'</span>][pkg] &gt; 0:
<a name="l01078"></a>01078 excuse.addhtml(<span class="stringliteral">"%s (%s) is (less) &lt;a href=\"http://bugs.debian.org/cgi-bin/pkgreport.cgi?"</span> \
<a name="l01079"></a>01079 <span class="stringliteral">"which=pkg&amp;data=%s&amp;sev-inc=critical&amp;sev-inc=grave&amp;sev-inc=serious\" "</span> \
<a name="l01080"></a>01080 <span class="stringliteral">"target=\"_blank\"&gt;buggy&lt;/a&gt;! (%d &lt;= %d)"</span> % \
<a name="l01081"></a>01081 (pkg, <span class="stringliteral">", "</span>.join(pkgs[pkg]), pkg, self.bugs[<span class="stringliteral">'unstable'</span>][pkg], self.bugs[<span class="stringliteral">'testing'</span>][pkg]))
<a name="l01082"></a>01082
<a name="l01083"></a>01083 <span class="comment"># check if there is a `force' hint for this package, which allows it to go in even if it is not updateable</span>
<a name="l01084"></a>01084 <span class="keywordflow">if</span> <span class="keywordflow">not</span> update_candidate <span class="keywordflow">and</span> self.hints[<span class="stringliteral">"force"</span>].has_key(src) <span class="keywordflow">and</span> \
<a name="l01085"></a>01085 self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(source_u[<span class="stringliteral">'version'</span>], self.hints[<span class="stringliteral">"force"</span>][src][0]):
<a name="l01086"></a>01086 excuse.dontinvalidate = 1
<a name="l01087"></a>01087 excuse.addhtml(<span class="stringliteral">"Should ignore, but forced by %s"</span> % (self.hints[<span class="stringliteral">"force"</span>][src][1]))
<a name="l01088"></a>01088 update_candidate = <span class="keyword">True</span>
<a name="l01089"></a>01089
<a name="l01090"></a>01090 <span class="comment"># if the suite is testing-proposed-updates, the package needs an explicit approval in order to go in</span>
<a name="l01091"></a>01091 <span class="keywordflow">if</span> suite == <span class="stringliteral">"tpu"</span>:
<a name="l01092"></a>01092 <span class="keywordflow">if</span> self.approvals.has_key(<span class="stringliteral">"%s_%s"</span> % (src, source_u[<span class="stringliteral">'version'</span>])):
<a name="l01093"></a>01093 excuse.addhtml(<span class="stringliteral">"Approved by %s"</span> % approvals[<span class="stringliteral">"%s_%s"</span> % (src, source_u[<span class="stringliteral">'version'</span>])])
<a name="l01094"></a>01094 <span class="keywordflow">else</span>:
<a name="l01095"></a>01095 excuse.addhtml(<span class="stringliteral">"NEEDS APPROVAL BY RM"</span>)
<a name="l01096"></a>01096 update_candidate = <span class="keyword">False</span>
<a name="l01097"></a>01097
<a name="l01098"></a>01098 <span class="comment"># if the package can be updated, it is a valid candidate</span>
<a name="l01099"></a><a class="code" href="classbritney_1_1Britney.html#be1b4af9d6c6650c70b24267412bc1a8">01099</a> <span class="keywordflow">if</span> update_candidate:
<a name="l01100"></a>01100 excuse.addhtml(<span class="stringliteral">"Valid candidate"</span>)
<a name="l01101"></a>01101 <span class="comment"># else it won't be considered</span>
<a name="l01102"></a>01102 <span class="keywordflow">else</span>:
<a name="l01103"></a>01103 excuse.addhtml(<span class="stringliteral">"Not considered"</span>)
<a name="l01104"></a>01104
<a name="l01105"></a>01105 self.excuses.append(excuse)
<a name="l01106"></a>01106 <span class="keywordflow">return</span> update_candidate
<a name="l01107"></a>01107
<a name="l01108"></a>01108 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#be1b4af9d6c6650c70b24267412bc1a8">reversed_exc_deps</a>(self):
<a name="l01109"></a>01109 <span class="stringliteral">"""Reverse the excuses dependencies</span>
<a name="l01110"></a>01110 <span class="stringliteral"></span>
<a name="l01111"></a>01111 <span class="stringliteral"> This method returns a dictionary where the keys are the package names</span>
<a name="l01112"></a><a class="code" href="classbritney_1_1Britney.html#171969785db449d7a06c3f762774e0cd">01112</a> <span class="stringliteral"> and the values are the excuse names which depend on it.</span>
<a name="l01113"></a>01113 <span class="stringliteral"> """</span>
<a name="l01114"></a>01114 res = {}
<a name="l01115"></a>01115 <span class="keywordflow">for</span> exc <span class="keywordflow">in</span> self.excuses:
<a name="l01116"></a>01116 <span class="keywordflow">for</span> d <span class="keywordflow">in</span> exc.deps:
<a name="l01117"></a>01117 <span class="keywordflow">if</span> <span class="keywordflow">not</span> res.has_key(d): res[d] = []
<a name="l01118"></a>01118 res[d].append(exc.name)
<a name="l01119"></a>01119 <span class="keywordflow">return</span> res
<a name="l01120"></a>01120
<a name="l01121"></a>01121 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#171969785db449d7a06c3f762774e0cd">invalidate_excuses</a>(self, valid, invalid):
<a name="l01122"></a>01122 <span class="stringliteral">"""Invalidate impossible excuses</span>
<a name="l01123"></a>01123 <span class="stringliteral"></span>
<a name="l01124"></a>01124 <span class="stringliteral"> This method invalidates the impossible excuses, which depend</span>
<a name="l01125"></a>01125 <span class="stringliteral"> on invalid excuses. The two parameters contains the list of</span>
<a name="l01126"></a>01126 <span class="stringliteral"> `valid' and `invalid' excuses.</span>
<a name="l01127"></a>01127 <span class="stringliteral"> """</span>
<a name="l01128"></a>01128 <span class="comment"># build a lookup-by-name map</span>
<a name="l01129"></a>01129 exclookup = {}
<a name="l01130"></a>01130 <span class="keywordflow">for</span> e <span class="keywordflow">in</span> self.excuses:
<a name="l01131"></a>01131 exclookup[e.name] = e
<a name="l01132"></a>01132
<a name="l01133"></a>01133 <span class="comment"># build the reverse dependencies</span>
<a name="l01134"></a>01134 revdeps = self.<a class="code" href="classbritney_1_1Britney.html#be1b4af9d6c6650c70b24267412bc1a8">reversed_exc_deps</a>()
<a name="l01135"></a>01135
<a name="l01136"></a>01136 <span class="comment"># loop on the invalid excuses</span>
<a name="l01137"></a>01137 i = 0
<a name="l01138"></a>01138 <span class="keywordflow">while</span> i &lt; len(invalid):
<a name="l01139"></a>01139 <span class="comment"># if there is no reverse dependency, skip the item</span>
<a name="l01140"></a>01140 <span class="keywordflow">if</span> <span class="keywordflow">not</span> revdeps.has_key(invalid[i]):
<a name="l01141"></a>01141 i += 1
<a name="l01142"></a>01142 <span class="keywordflow">continue</span>
<a name="l01143"></a>01143 <span class="comment"># if there dependency can be satisfied by a testing-proposed-updates excuse, skip the item</span>
<a name="l01144"></a>01144 <span class="keywordflow">if</span> (invalid[i] + <span class="stringliteral">"_tpu"</span>) <span class="keywordflow">in</span> valid:
<a name="l01145"></a>01145 i += 1
<a name="l01146"></a>01146 <span class="keywordflow">continue</span>
<a name="l01147"></a>01147 <span class="comment"># loop on the reverse dependencies</span>
<a name="l01148"></a>01148 <span class="keywordflow">for</span> x <span class="keywordflow">in</span> revdeps[invalid[i]]:
<a name="l01149"></a>01149 <span class="comment"># if the item is valid and it is marked as `dontinvalidate', skip the item</span>
<a name="l01150"></a>01150 <span class="keywordflow">if</span> x <span class="keywordflow">in</span> valid <span class="keywordflow">and</span> exclookup[x].dontinvalidate:
<a name="l01151"></a>01151 <span class="keywordflow">continue</span>
<a name="l01152"></a>01152
<a name="l01153"></a>01153 <span class="comment"># otherwise, invalidate the dependency and mark as invalidated and</span>
<a name="l01154"></a><a class="code" href="classbritney_1_1Britney.html#010f6deffca32f7f71ecf1f5c1bb4985">01154</a> <span class="comment"># remove the depending excuses</span>
<a name="l01155"></a>01155 exclookup[x].invalidate_dep(invalid[i])
<a name="l01156"></a>01156 <span class="keywordflow">if</span> x <span class="keywordflow">in</span> valid:
<a name="l01157"></a>01157 p = valid.index(x)
<a name="l01158"></a>01158 invalid.append(valid.pop(p))
<a name="l01159"></a>01159 exclookup[x].addhtml(<span class="stringliteral">"Invalidated by dependency"</span>)
<a name="l01160"></a>01160 exclookup[x].addhtml(<span class="stringliteral">"Not considered"</span>)
<a name="l01161"></a>01161 i = i + 1
<a name="l01162"></a>01162
<a name="l01163"></a>01163 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#010f6deffca32f7f71ecf1f5c1bb4985">write_excuses</a>(self):
<a name="l01164"></a>01164 <span class="stringliteral">"""Produce and write the update excuses</span>
<a name="l01165"></a>01165 <span class="stringliteral"></span>
<a name="l01166"></a>01166 <span class="stringliteral"> This method handles the update excuses generation: the packages are</span>
<a name="l01167"></a>01167 <span class="stringliteral"> looked to determine whether they are valid candidates. For the details</span>
<a name="l01168"></a>01168 <span class="stringliteral"> of this procedure, please refer to the module docstring.</span>
<a name="l01169"></a>01169 <span class="stringliteral"> """</span>
<a name="l01170"></a>01170
<a name="l01171"></a>01171 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Update Excuses generation started"</span>, type=<span class="stringliteral">"I"</span>)
<a name="l01172"></a>01172
<a name="l01173"></a>01173 <span class="comment"># this list will contain the packages which are valid candidates;</span>
<a name="l01174"></a>01174 <span class="comment"># if a package is going to be removed, it will have a "-" prefix</span>
<a name="l01175"></a>01175 upgrade_me = []
<a name="l01176"></a>01176
<a name="l01177"></a>01177 <span class="comment"># for every source package in testing, check if it should be removed</span>
<a name="l01178"></a>01178 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> self.sources[<span class="stringliteral">'testing'</span>]:
<a name="l01179"></a>01179 <span class="keywordflow">if</span> self.<a class="code" href="classbritney_1_1Britney.html#f8a6c9adbdec7a5a982dd2b74febcc08">should_remove_source</a>(pkg):
<a name="l01180"></a>01180 upgrade_me.append(<span class="stringliteral">"-"</span> + pkg)
<a name="l01181"></a>01181
<a name="l01182"></a>01182 <span class="comment"># for every source package in unstable check if it should be upgraded</span>
<a name="l01183"></a>01183 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> self.sources[<span class="stringliteral">'unstable'</span>]:
<a name="l01184"></a>01184 <span class="comment"># if the source package is already present in testing,</span>
<a name="l01185"></a>01185 <span class="comment"># check if it should be upgraded for every binary package</span>
<a name="l01186"></a>01186 <span class="keywordflow">if</span> self.sources[<span class="stringliteral">'testing'</span>].has_key(pkg):
<a name="l01187"></a>01187 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l01188"></a>01188 <span class="keywordflow">if</span> self.<a class="code" href="classbritney_1_1Britney.html#bd18d7acde434387e94344a39db5b0e5">should_upgrade_srcarch</a>(pkg, arch, <span class="stringliteral">'unstable'</span>):
<a name="l01189"></a>01189 upgrade_me.append(<span class="stringliteral">"%s/%s"</span> % (pkg, arch))
<a name="l01190"></a>01190
<a name="l01191"></a>01191 <span class="comment"># check if the source package should be upgraded</span>
<a name="l01192"></a>01192 <span class="keywordflow">if</span> self.<a class="code" href="classbritney_1_1Britney.html#94785175a85f44b1afaf3add167a211f">should_upgrade_src</a>(pkg, <span class="stringliteral">'unstable'</span>):
<a name="l01193"></a>01193 upgrade_me.append(pkg)
<a name="l01194"></a>01194
<a name="l01195"></a>01195 <span class="comment"># for every source package in testing-proposed-updates, check if it should be upgraded</span>
<a name="l01196"></a>01196 <span class="keywordflow">for</span> pkg <span class="keywordflow">in</span> self.sources[<span class="stringliteral">'tpu'</span>]:
<a name="l01197"></a>01197 <span class="comment"># if the source package is already present in testing,</span>
<a name="l01198"></a>01198 <span class="comment"># check if it should be upgraded for every binary package</span>
<a name="l01199"></a>01199 <span class="keywordflow">if</span> self.sources[<span class="stringliteral">'testing'</span>].has_key(pkg):
<a name="l01200"></a>01200 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l01201"></a>01201 <span class="keywordflow">if</span> self.<a class="code" href="classbritney_1_1Britney.html#bd18d7acde434387e94344a39db5b0e5">should_upgrade_srcarch</a>(pkg, arch, <span class="stringliteral">'tpu'</span>):
<a name="l01202"></a>01202 upgrade_me.append(<span class="stringliteral">"%s/%s_tpu"</span> % (pkg, arch))
<a name="l01203"></a>01203
<a name="l01204"></a>01204 <span class="comment"># check if the source package should be upgraded</span>
<a name="l01205"></a>01205 <span class="keywordflow">if</span> self.<a class="code" href="classbritney_1_1Britney.html#94785175a85f44b1afaf3add167a211f">should_upgrade_src</a>(pkg, <span class="stringliteral">'tpu'</span>):
<a name="l01206"></a>01206 upgrade_me.append(<span class="stringliteral">"%s_tpu"</span> % pkg)
<a name="l01207"></a>01207
<a name="l01208"></a>01208 <span class="comment"># process the `remove' hints, if the given package is not yet in upgrade_me</span>
<a name="l01209"></a>01209 <span class="keywordflow">for</span> src <span class="keywordflow">in</span> self.hints[<span class="stringliteral">"remove"</span>].keys():
<a name="l01210"></a>01210 <span class="keywordflow">if</span> src <span class="keywordflow">in</span> upgrade_me: <span class="keywordflow">continue</span>
<a name="l01211"></a>01211 <span class="keywordflow">if</span> (<span class="stringliteral">"-"</span>+src) <span class="keywordflow">in</span> upgrade_me: <span class="keywordflow">continue</span>
<a name="l01212"></a>01212 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.sources[<span class="stringliteral">'testing'</span>].has_key(src): <span class="keywordflow">continue</span>
<a name="l01213"></a>01213
<a name="l01214"></a>01214 <span class="comment"># check if the version specified in the hint is the same of the considered package</span>
<a name="l01215"></a>01215 tsrcv = self.sources[<span class="stringliteral">'testing'</span>][src][<span class="stringliteral">'version'</span>]
<a name="l01216"></a>01216 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.<a class="code" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a>(tsrcv, self.hints[<span class="stringliteral">"remove"</span>][src][0]): <span class="keywordflow">continue</span>
<a name="l01217"></a>01217
<a name="l01218"></a>01218 <span class="comment"># add the removal of the package to upgrade_me and build a new excuse</span>
<a name="l01219"></a>01219 upgrade_me.append(<span class="stringliteral">"-%s"</span> % (src))
<a name="l01220"></a>01220 excuse = Excuse(<span class="stringliteral">"-%s"</span> % (src))
<a name="l01221"></a>01221 excuse.set_vers(tsrcv, <span class="keywordtype">None</span>)
<a name="l01222"></a>01222 excuse.addhtml(<span class="stringliteral">"Removal request by %s"</span> % (self.hints[<span class="stringliteral">"remove"</span>][src][1]))
<a name="l01223"></a>01223 excuse.addhtml(<span class="stringliteral">"Package is broken, will try to remove"</span>)
<a name="l01224"></a>01224 self.excuses.append(excuse)
<a name="l01225"></a>01225
<a name="l01226"></a>01226 <span class="comment"># sort the excuses by daysold and name</span>
<a name="l01227"></a>01227 self.excuses.sort(<span class="keyword">lambda</span> x, y: cmp(x.daysold, y.daysold) <span class="keywordflow">or</span> cmp(x.name, y.name))
<a name="l01228"></a>01228
<a name="l01229"></a>01229 <span class="comment"># extract the not considered packages, which are in the excuses but not in upgrade_me</span>
<a name="l01230"></a>01230 unconsidered = [e.name <span class="keywordflow">for</span> e <span class="keywordflow">in</span> self.excuses <span class="keywordflow">if</span> e.name <span class="keywordflow">not</span> <span class="keywordflow">in</span> upgrade_me]
<a name="l01231"></a>01231
<a name="l01232"></a>01232 <span class="comment"># invalidate impossible excuses</span>
<a name="l01233"></a>01233 <span class="keywordflow">for</span> e <span class="keywordflow">in</span> self.excuses:
<a name="l01234"></a>01234 <span class="keywordflow">for</span> d <span class="keywordflow">in</span> e.deps:
<a name="l01235"></a>01235 <span class="keywordflow">if</span> d <span class="keywordflow">not</span> <span class="keywordflow">in</span> upgrade_me <span class="keywordflow">and</span> d <span class="keywordflow">not</span> <span class="keywordflow">in</span> unconsidered:
<a name="l01236"></a>01236 e.addhtml(<span class="stringliteral">"Unpossible dep: %s -&gt; %s"</span> % (e.name, d))
<a name="l01237"></a>01237 self.<a class="code" href="classbritney_1_1Britney.html#171969785db449d7a06c3f762774e0cd">invalidate_excuses</a>(upgrade_me, unconsidered)
<a name="l01238"></a>01238
<a name="l01239"></a>01239 self.upgrade_me = sorted(upgrade_me)
<a name="l01240"></a>01240
<a name="l01241"></a>01241 <span class="comment"># write excuses to the output file</span>
<a name="l01242"></a>01242 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Writing Excuses to %s"</span> % self.options.excuses_output, type=<span class="stringliteral">"I"</span>)
<a name="l01243"></a>01243
<a name="l01244"></a>01244 f = open(self.options.excuses_output, <span class="stringliteral">'w'</span>)
<a name="l01245"></a>01245 f.write(<span class="stringliteral">"&lt;!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://www.w3.org/TR/REC-html40/strict.dtd\"&gt;\n"</span>)
<a name="l01246"></a>01246 f.write(<span class="stringliteral">"&lt;html&gt;&lt;head&gt;&lt;title&gt;excuses...&lt;/title&gt;"</span>)
<a name="l01247"></a>01247 f.write(<span class="stringliteral">"&lt;meta http-equiv=\"Content-Type\" content=\"text/html;charset=utf-8\"&gt;&lt;/head&gt;&lt;body&gt;\n"</span>)
<a name="l01248"></a>01248 f.write(<span class="stringliteral">"&lt;p&gt;Generated: "</span> + time.strftime(<span class="stringliteral">"%Y.%m.%d %H:%M:%S %z"</span>, time.gmtime(time.time())) + <span class="stringliteral">"&lt;/p&gt;\n"</span>)
<a name="l01249"></a>01249 f.write(<span class="stringliteral">"&lt;ul&gt;\n"</span>)
<a name="l01250"></a>01250 <span class="keywordflow">for</span> e <span class="keywordflow">in</span> self.excuses:
<a name="l01251"></a><a class="code" href="classbritney_1_1Britney.html#41c5ee0b9d64b2e76a0c1a1c2b28c73e">01251</a> f.write(<span class="stringliteral">"&lt;li&gt;%s"</span> % e.html())
<a name="l01252"></a>01252 f.write(<span class="stringliteral">"&lt;/ul&gt;&lt;/body&gt;&lt;/html&gt;\n"</span>)
<a name="l01253"></a>01253 f.close()
<a name="l01254"></a>01254
<a name="l01255"></a>01255 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Update Excuses generation completed"</span>, type=<span class="stringliteral">"I"</span>)
<a name="l01256"></a>01256
<a name="l01257"></a>01257 <span class="comment"># Upgrade run</span>
<a name="l01258"></a>01258 <span class="comment"># -----------</span>
<a name="l01259"></a>01259
<a name="l01260"></a>01260 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#41c5ee0b9d64b2e76a0c1a1c2b28c73e">get_nuninst</a>(self):
<a name="l01261"></a>01261 nuninst = {}
<a name="l01262"></a>01262
<a name="l01263"></a>01263 <span class="keyword">def </span>add_nuninst(pkg, arch):
<a name="l01264"></a>01264 <span class="keywordflow">if</span> pkg <span class="keywordflow">not</span> <span class="keywordflow">in</span> nuninst[arch]:
<a name="l01265"></a>01265 nuninst[arch].append(pkg)
<a name="l01266"></a>01266 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][pkg][<span class="stringliteral">'rdepends'</span>]:
<a name="l01267"></a>01267 tpkg = self.binaries[<span class="stringliteral">'testing'</span>][arch][0][p[0]]
<a name="l01268"></a>01268 <span class="keywordflow">if</span> skip_archall <span class="keywordflow">and</span> tpkg[<span class="stringliteral">'architecture'</span>] == <span class="stringliteral">'all'</span>:
<a name="l01269"></a>01269 <span class="keywordflow">continue</span>
<a name="l01270"></a>01270 r = self.<a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a>(p[0], tpkg[<span class="stringliteral">'source'</span>], arch, <span class="stringliteral">'testing'</span>, <span class="keywordtype">None</span>, excluded=nuninst[arch])
<a name="l01271"></a>01271 <span class="keywordflow">if</span> <span class="keywordflow">not</span> r:
<a name="l01272"></a>01272 add_nuninst(p[0], arch)
<a name="l01273"></a>01273
<a name="l01274"></a>01274 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l01275"></a>01275 <span class="keywordflow">if</span> arch <span class="keywordflow">not</span> <span class="keywordflow">in</span> self.options.nobreakall_arches:
<a name="l01276"></a>01276 skip_archall = <span class="keyword">True</span>
<a name="l01277"></a>01277 <span class="keywordflow">else</span>: skip_archall = <span class="keyword">False</span>
<a name="l01278"></a>01278
<a name="l01279"></a>01279 nuninst[arch] = []
<a name="l01280"></a>01280 <span class="keywordflow">for</span> pkg_name <span class="keywordflow">in</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0]:
<a name="l01281"></a><a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">01281</a> pkg = self.binaries[<span class="stringliteral">'testing'</span>][arch][0][pkg_name]
<a name="l01282"></a>01282 <span class="keywordflow">if</span> skip_archall <span class="keywordflow">and</span> pkg[<span class="stringliteral">'architecture'</span>] == <span class="stringliteral">'all'</span>:
<a name="l01283"></a>01283 <span class="keywordflow">continue</span>
<a name="l01284"></a>01284 r = self.<a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a>(pkg_name, pkg[<span class="stringliteral">'source'</span>], arch, <span class="stringliteral">'testing'</span>, <span class="keywordtype">None</span>, excluded=nuninst[arch])
<a name="l01285"></a>01285 <span class="keywordflow">if</span> <span class="keywordflow">not</span> r:
<a name="l01286"></a>01286 add_nuninst(pkg_name, arch)
<a name="l01287"></a>01287
<a name="l01288"></a>01288 <span class="keywordflow">return</span> nuninst
<a name="l01289"></a>01289
<a name="l01290"></a>01290 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a>(self, nuninst):
<a name="l01291"></a>01291 res = []
<a name="l01292"></a>01292 total = 0
<a name="l01293"></a>01293 totalbreak = 0
<a name="l01294"></a>01294 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l01295"></a><a class="code" href="classbritney_1_1Britney.html#b8dd18ead23b6e1126bb4c2a5c3cd8ba">01295</a> <span class="keywordflow">if</span> nuninst.has_key(arch):
<a name="l01296"></a>01296 n = len(nuninst[arch])
<a name="l01297"></a>01297 <span class="keywordflow">if</span> arch <span class="keywordflow">in</span> self.options.break_arches:
<a name="l01298"></a>01298 totalbreak = totalbreak + n
<a name="l01299"></a>01299 <span class="keywordflow">else</span>:
<a name="l01300"></a>01300 total = total + n
<a name="l01301"></a>01301 res.append(<span class="stringliteral">"%s-%d"</span> % (arch[0], n))
<a name="l01302"></a>01302 <span class="keywordflow">return</span> <span class="stringliteral">"%d+%d: %s"</span> % (total, totalbreak, <span class="stringliteral">":"</span>.join(res))
<a name="l01303"></a><a class="code" href="classbritney_1_1Britney.html#22af61b8a7f6fe71a79d28b5016cae1d">01303</a>
<a name="l01304"></a>01304 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#b8dd18ead23b6e1126bb4c2a5c3cd8ba">eval_uninst</a>(self, nuninst):
<a name="l01305"></a>01305 res = <span class="stringliteral">""</span>
<a name="l01306"></a>01306 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.arches:
<a name="l01307"></a>01307 <span class="keywordflow">if</span> nuninst.has_key(arch) <span class="keywordflow">and</span> nuninst[arch] != []:
<a name="l01308"></a>01308 res = res + <span class="stringliteral">" * %s: %s\n"</span> % (arch,
<a name="l01309"></a>01309 <span class="stringliteral">", "</span>.join(nuninst[arch]))
<a name="l01310"></a>01310 <span class="keywordflow">return</span> res
<a name="l01311"></a>01311
<a name="l01312"></a>01312 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#22af61b8a7f6fe71a79d28b5016cae1d">doop_source</a>(self, pkg):
<a name="l01313"></a>01313
<a name="l01314"></a>01314 undo = {<span class="stringliteral">'binaries'</span>: {}, <span class="stringliteral">'sources'</span>: {}}
<a name="l01315"></a>01315
<a name="l01316"></a>01316 affected = []
<a name="l01317"></a>01317
<a name="l01318"></a>01318 <span class="comment"># arch = "&lt;source&gt;/&lt;arch&gt;",</span>
<a name="l01319"></a>01319 <span class="keywordflow">if</span> <span class="stringliteral">"/"</span> <span class="keywordflow">in</span> pkg:
<a name="l01320"></a>01320 <span class="keywordflow">print</span> <span class="stringliteral">"NOT HANDLED!"</span>
<a name="l01321"></a>01321 sys.exit(1)
<a name="l01322"></a>01322
<a name="l01323"></a>01323 <span class="comment"># removals = "-&lt;source&gt;",</span>
<a name="l01324"></a>01324 <span class="comment"># normal = "&lt;source&gt;"</span>
<a name="l01325"></a>01325 <span class="keywordflow">else</span>:
<a name="l01326"></a>01326 <span class="keywordflow">if</span> pkg[0] == <span class="stringliteral">"-"</span>:
<a name="l01327"></a>01327 pkg_name = pkg[1:]
<a name="l01328"></a>01328 suite = <span class="stringliteral">"testing"</span>
<a name="l01329"></a>01329 <span class="keywordflow">elif</span> pkg[0].endswith(<span class="stringliteral">"_tpu"</span>):
<a name="l01330"></a>01330 pkg_name = pkg[:-4]
<a name="l01331"></a>01331 suite = <span class="stringliteral">"tpu"</span>
<a name="l01332"></a>01332 <span class="keywordflow">else</span>:
<a name="l01333"></a>01333 pkg_name = pkg
<a name="l01334"></a>01334 suite = <span class="stringliteral">"unstable"</span>
<a name="l01335"></a>01335
<a name="l01336"></a>01336 <span class="comment"># remove all binary packages (if the source already exists)</span>
<a name="l01337"></a>01337 <span class="keywordflow">if</span> pkg_name <span class="keywordflow">in</span> self.sources[<span class="stringliteral">'testing'</span>]:
<a name="l01338"></a>01338 source = self.sources[<span class="stringliteral">'testing'</span>][pkg_name]
<a name="l01339"></a>01339 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> source[<span class="stringliteral">'binaries'</span>]:
<a name="l01340"></a>01340 binary, arch = p.split(<span class="stringliteral">"/"</span>)
<a name="l01341"></a>01341 undo[<span class="stringliteral">'binaries'</span>][p] = self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary]
<a name="l01342"></a>01342 <span class="keywordflow">for</span> j <span class="keywordflow">in</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary][<span class="stringliteral">'rdepends'</span>]:
<a name="l01343"></a>01343 <span class="keywordflow">if</span> j <span class="keywordflow">not</span> <span class="keywordflow">in</span> affected: affected.append((j[0], j[1], j[2], arch))
<a name="l01344"></a>01344 del self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary]
<a name="l01345"></a>01345 undo[<span class="stringliteral">'sources'</span>][pkg_name] = source
<a name="l01346"></a>01346 del self.sources[<span class="stringliteral">'testing'</span>][pkg_name]
<a name="l01347"></a>01347
<a name="l01348"></a>01348 <span class="comment"># add the new binary packages (if we are not removing)</span>
<a name="l01349"></a>01349 <span class="keywordflow">if</span> pkg[0] != <span class="stringliteral">"-"</span>:
<a name="l01350"></a>01350 source = self.sources[suite][pkg_name]
<a name="l01351"></a>01351 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> source[<span class="stringliteral">'binaries'</span>]:
<a name="l01352"></a>01352 binary, arch = p.split(<span class="stringliteral">"/"</span>)
<a name="l01353"></a>01353 <span class="keywordflow">if</span> p <span class="keywordflow">not</span> <span class="keywordflow">in</span> affected:
<a name="l01354"></a>01354 affected.append((binary, <span class="keywordtype">None</span>, <span class="keywordtype">None</span>, arch))
<a name="l01355"></a><a class="code" href="classbritney_1_1Britney.html#d453398832baaa7f477f720cfb643029">01355</a> <span class="keywordflow">if</span> binary <span class="keywordflow">in</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0]:
<a name="l01356"></a>01356 undo[<span class="stringliteral">'binaries'</span>][p] = self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary]
<a name="l01357"></a>01357 self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary] = self.binaries[suite][arch][0][binary]
<a name="l01358"></a>01358 <span class="keywordflow">for</span> j <span class="keywordflow">in</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary][<span class="stringliteral">'rdepends'</span>]:
<a name="l01359"></a>01359 <span class="keywordflow">if</span> j <span class="keywordflow">not</span> <span class="keywordflow">in</span> affected: affected.append((j[0], j[1], j[2], arch))
<a name="l01360"></a>01360 self.sources[<span class="stringliteral">'testing'</span>][pkg_name] = self.sources[suite][pkg_name]
<a name="l01361"></a>01361
<a name="l01362"></a>01362 <span class="keywordflow">return</span> (pkg_name, suite, affected, undo)
<a name="l01363"></a>01363
<a name="l01364"></a>01364 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#d453398832baaa7f477f720cfb643029">iter_packages</a>(self, packages, output):
<a name="l01365"></a>01365 extra = []
<a name="l01366"></a>01366 nuninst_comp = self.<a class="code" href="classbritney_1_1Britney.html#41c5ee0b9d64b2e76a0c1a1c2b28c73e">get_nuninst</a>()
<a name="l01367"></a>01367
<a name="l01368"></a>01368 <span class="keywordflow">while</span> packages:
<a name="l01369"></a>01369 pkg = packages.pop(0)
<a name="l01370"></a>01370 output.write(<span class="stringliteral">"trying: %s\n"</span> % (pkg))
<a name="l01371"></a>01371
<a name="l01372"></a>01372 better = <span class="keyword">True</span>
<a name="l01373"></a>01373 nuninst = {}
<a name="l01374"></a>01374
<a name="l01375"></a>01375 pkg_name, suite, affected, undo = self.<a class="code" href="classbritney_1_1Britney.html#22af61b8a7f6fe71a79d28b5016cae1d">doop_source</a>(pkg)
<a name="l01376"></a>01376 broken = []
<a name="l01377"></a>01377
<a name="l01378"></a>01378 <span class="keywordflow">for</span> arch <span class="keywordflow">in</span> self.options.architectures:
<a name="l01379"></a>01379 <span class="keywordflow">if</span> arch <span class="keywordflow">not</span> <span class="keywordflow">in</span> self.options.nobreakall_arches:
<a name="l01380"></a>01380 skip_archall = <span class="keyword">True</span>
<a name="l01381"></a>01381 <span class="keywordflow">else</span>: skip_archall = <span class="keyword">False</span>
<a name="l01382"></a>01382
<a name="l01383"></a>01383 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> filter(<span class="keyword">lambda</span> x: x[3] == arch, affected):
<a name="l01384"></a>01384 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0].has_key(p[0]) <span class="keywordflow">or</span> \
<a name="l01385"></a>01385 skip_archall <span class="keywordflow">and</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][p[0]][<span class="stringliteral">'architecture'</span>] == <span class="stringliteral">'all'</span>: <span class="keywordflow">continue</span>
<a name="l01386"></a>01386 r = self.<a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a>(p[0], <span class="keywordtype">None</span>, arch, <span class="stringliteral">'testing'</span>, <span class="keywordtype">None</span>, excluded=[])
<a name="l01387"></a>01387 <span class="keywordflow">if</span> <span class="keywordflow">not</span> r <span class="keywordflow">and</span> p[0] <span class="keywordflow">not</span> <span class="keywordflow">in</span> broken: broken.append(p[0])
<a name="l01388"></a>01388
<a name="l01389"></a>01389 l = 0
<a name="l01390"></a>01390 <span class="keywordflow">while</span> l &lt; len(broken):
<a name="l01391"></a>01391 l = len(broken)
<a name="l01392"></a>01392 <span class="keywordflow">for</span> j <span class="keywordflow">in</span> broken:
<a name="l01393"></a>01393 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][j][<span class="stringliteral">'rdepends'</span>]:
<a name="l01394"></a>01394 <span class="keywordflow">if</span> <span class="keywordflow">not</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0].has_key(p[0]) <span class="keywordflow">or</span> \
<a name="l01395"></a>01395 skip_archall <span class="keywordflow">and</span> self.binaries[<span class="stringliteral">'testing'</span>][arch][0][p[0]][<span class="stringliteral">'architecture'</span>] == <span class="stringliteral">'all'</span>: <span class="keywordflow">continue</span>
<a name="l01396"></a>01396 r = self.<a class="code" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a>(p[0], <span class="keywordtype">None</span>, arch, <span class="stringliteral">'testing'</span>, <span class="keywordtype">None</span>, excluded=broken)
<a name="l01397"></a>01397 <span class="keywordflow">if</span> <span class="keywordflow">not</span> r <span class="keywordflow">and</span> p[0] <span class="keywordflow">not</span> <span class="keywordflow">in</span> broken: broken.append(p[0])
<a name="l01398"></a>01398
<a name="l01399"></a>01399 nuninst[arch] = sorted(broken)
<a name="l01400"></a>01400 <span class="keywordflow">if</span> len(nuninst[arch]) &gt; 0:
<a name="l01401"></a>01401 better = <span class="keyword">False</span>
<a name="l01402"></a>01402 <span class="keywordflow">break</span>
<a name="l01403"></a>01403
<a name="l01404"></a>01404 <span class="keywordflow">if</span> better:
<a name="l01405"></a>01405 self.<a class="code" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">selected</a>.append(pkg)
<a name="l01406"></a>01406 packages.extend(extra)
<a name="l01407"></a>01407 extra = []
<a name="l01408"></a>01408 nuninst_new = nuninst_comp <span class="comment"># FIXME!</span>
<a name="l01409"></a>01409 output.write(<span class="stringliteral">"accepted: %s\n"</span> % (pkg))
<a name="l01410"></a>01410 output.write(<span class="stringliteral">" ori: %s\n"</span> % (self.<a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a>(self.<a class="code" href="classbritney_1_1Britney.html#d6169c55786a8ec7fb9773170b652da6">nuninst_orig</a>)))
<a name="l01411"></a>01411 output.write(<span class="stringliteral">" pre: %s\n"</span> % (self.<a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a>(nuninst_comp)))
<a name="l01412"></a>01412 output.write(<span class="stringliteral">" now: %s\n"</span> % (self.<a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a>(nuninst_new)))
<a name="l01413"></a>01413 <span class="keywordflow">if</span> len(self.<a class="code" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">selected</a>) &lt;= 20:
<a name="l01414"></a>01414 output.write(<span class="stringliteral">" all: %s\n"</span> % (<span class="stringliteral">" "</span>.join(self.<a class="code" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">selected</a>)))
<a name="l01415"></a>01415 <span class="keywordflow">else</span>:
<a name="l01416"></a>01416 output.write(<span class="stringliteral">" most: (%d) .. %s\n"</span> % (len(self.<a class="code" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">selected</a>), <span class="stringliteral">" "</span>.join(self.<a class="code" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">selected</a>[-20:])))
<a name="l01417"></a>01417 nuninst_comp = nuninst_new
<a name="l01418"></a>01418 <span class="keywordflow">else</span>:
<a name="l01419"></a>01419 output.write(<span class="stringliteral">"skipped: %s (%d &lt;- %d)\n"</span> % (pkg, len(extra), len(packages)))
<a name="l01420"></a>01420 output.write(<span class="stringliteral">" got: %s\n"</span> % self.<a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a>(nuninst))
<a name="l01421"></a>01421 output.write(<span class="stringliteral">" * %s: %s\n"</span> % (arch, <span class="stringliteral">", "</span>.join(nuninst[arch])))
<a name="l01422"></a>01422 extra.append(pkg)
<a name="l01423"></a>01423
<a name="l01424"></a>01424 <span class="comment"># undo the changes (source and new binaries)</span>
<a name="l01425"></a>01425 <span class="keywordflow">for</span> k <span class="keywordflow">in</span> undo[<span class="stringliteral">'sources'</span>].keys():
<a name="l01426"></a>01426 <span class="keywordflow">if</span> k <span class="keywordflow">in</span> self.sources[suite]:
<a name="l01427"></a>01427 <span class="keywordflow">for</span> p <span class="keywordflow">in</span> self.sources[suite][k][<span class="stringliteral">'binaries'</span>]:
<a name="l01428"></a>01428 binary, arch = p.split(<span class="stringliteral">"/"</span>)
<a name="l01429"></a>01429 del self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary]
<a name="l01430"></a><a class="code" href="classbritney_1_1Britney.html#3ef9b6f600eac492fc5aa4b31638198f">01430</a> del self.sources[<span class="stringliteral">'testing'</span>][k]
<a name="l01431"></a>01431 self.sources[<span class="stringliteral">'testing'</span>][k] = undo[<span class="stringliteral">'sources'</span>][k]
<a name="l01432"></a>01432
<a name="l01433"></a>01433 <span class="comment"># undo the changes (binaries)</span>
<a name="l01434"></a><a class="code" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">01434</a> <span class="keywordflow">for</span> p <span class="keywordflow">in</span> undo[<span class="stringliteral">'binaries'</span>].keys():
<a name="l01435"></a><a class="code" href="classbritney_1_1Britney.html#d6169c55786a8ec7fb9773170b652da6">01435</a> binary, arch = p.split(<span class="stringliteral">"/"</span>)
<a name="l01436"></a>01436 self.binaries[<span class="stringliteral">'testing'</span>][arch][0][binary] = undo[<span class="stringliteral">'binaries'</span>][p]
<a name="l01437"></a>01437
<a name="l01438"></a><a class="code" href="classbritney_1_1Britney.html#921effe0d64ed713c38888684a0a26d4">01438</a>
<a name="l01439"></a>01439 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#3ef9b6f600eac492fc5aa4b31638198f">do_all</a>(self, output):
<a name="l01440"></a>01440 nuninst_start = self.<a class="code" href="classbritney_1_1Britney.html#41c5ee0b9d64b2e76a0c1a1c2b28c73e">get_nuninst</a>()
<a name="l01441"></a>01441 output.write(<span class="stringliteral">"start: %s\n"</span> % self.<a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a>(nuninst_start))
<a name="l01442"></a>01442 output.write(<span class="stringliteral">"orig: %s\n"</span> % self.<a class="code" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a>(nuninst_start))
<a name="l01443"></a>01443 self.<a class="code" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">selected</a> = []
<a name="l01444"></a>01444 self.<a class="code" href="classbritney_1_1Britney.html#d6169c55786a8ec7fb9773170b652da6">nuninst_orig</a> = nuninst_start
<a name="l01445"></a>01445 self.<a class="code" href="classbritney_1_1Britney.html#d453398832baaa7f477f720cfb643029">iter_packages</a>(self.upgrade_me, output)
<a name="l01446"></a>01446
<a name="l01447"></a>01447 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#921effe0d64ed713c38888684a0a26d4">upgrade_testing</a>(self):
<a name="l01448"></a>01448 <span class="stringliteral">"""Upgrade testing using the unstable packages</span>
<a name="l01449"></a>01449 <span class="stringliteral"></span>
<a name="l01450"></a>01450 <span class="stringliteral"> This method tries to upgrade testing using the packages from unstable.</span>
<a name="l01451"></a>01451 <span class="stringliteral"> """</span>
<a name="l01452"></a>01452
<a name="l01453"></a>01453 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Starting the upgrade test"</span>, type=<span class="stringliteral">"I"</span>)
<a name="l01454"></a>01454 output = open(self.options.upgrade_output, <span class="stringliteral">'w'</span>)
<a name="l01455"></a><a class="code" href="classbritney_1_1Britney.html#0e9551bdf927388f55be5ce15a48c94f">01455</a> output.write(<span class="stringliteral">"Generated on: %s\n"</span> % (time.strftime(<span class="stringliteral">"%Y.%m.%d %H:%M:%S %z"</span>, time.gmtime(time.time()))))
<a name="l01456"></a>01456 output.write(<span class="stringliteral">"Arch order is: %s\n"</span> % <span class="stringliteral">", "</span>.join(self.options.architectures))
<a name="l01457"></a>01457
<a name="l01458"></a>01458 <span class="comment"># TODO: process hints!</span>
<a name="l01459"></a>01459 self.<a class="code" href="classbritney_1_1Britney.html#3ef9b6f600eac492fc5aa4b31638198f">do_all</a>(output)
<a name="l01460"></a>01460
<a name="l01461"></a>01461 output.close()
<a name="l01462"></a>01462 self.<a class="code" href="classbritney_1_1Britney.html#678036a5200302d77249f5e702532681">__log</a>(<span class="stringliteral">"Test completed!"</span>, type=<span class="stringliteral">"I"</span>)
<a name="l01463"></a>01463
<a name="l01464"></a>01464 <span class="keyword">def </span><a class="code" href="classbritney_1_1Britney.html#0e9551bdf927388f55be5ce15a48c94f">main</a>(self):
<a name="l01465"></a>01465 <span class="stringliteral">"""Main method</span>
<a name="l01466"></a>01466 <span class="stringliteral"> </span>
<a name="l01467"></a>01467 <span class="stringliteral"> This is the entry point for the class: it includes the list of calls</span>
<a name="l01468"></a>01468 <span class="stringliteral"> for the member methods which will produce the output files.</span>
<a name="l01469"></a>01469 <span class="stringliteral"> """</span>
<a name="l01470"></a>01470 self.<a class="code" href="classbritney_1_1Britney.html#010f6deffca32f7f71ecf1f5c1bb4985">write_excuses</a>()
<a name="l01471"></a>01471 self.<a class="code" href="classbritney_1_1Britney.html#921effe0d64ed713c38888684a0a26d4">upgrade_testing</a>()
<a name="l01472"></a>01472
<a name="l01473"></a>01473 <span class="keywordflow">if</span> __name__ == <span class="stringliteral">'__main__'</span>:
<a name="l01474"></a>01474 Britney().main()
</pre></div><hr size="1"><address style="align: right;"><small>Generated on Sat Jul 22 09:29:59 2006 for briteny by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.7 </small></address>
</body>
</html>