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.
britney2-ubuntu/doc/html/classbritney_1_1Britney.html

947 lines
40 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.Britney Class Reference</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 id="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul></div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
<li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
</ul></div>
<div class="nav">
<a class="el" href="namespacebritney.html">britney</a>.<a class="el" href="classbritney_1_1Britney.html">Britney</a></div>
<h1>britney.Britney Class Reference</h1><!-- doxytag: class="britney::Britney" --><a href="classbritney_1_1Britney-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#5846d81eace24f479292c47e30fd1851">__init__</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#054f44c47f17c0c4f5a069e821b7f868">read_sources</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#1b2b0f42e4af1cee472f93e955b30421">read_binaries</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#6c777aae69e7bec2efebaf23ddd4a86c">read_bugs</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#5a6af4a100cfd54e872a27fa7f48ac3c">normalize_bugs</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#085af5ac906813ea40fc2e623748f517">read_dates</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#09fc27899506b4830b1961f125a7b6a4">read_urgencies</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#39248f0cfea1c8798b2ca5a97d37eaf8">read_approvals</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#46d535f617fcf1faaaf5d841ea23c184">read_hints</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#85d2e45e8431779b62f398c34972ddf1">same_source</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#5461f49e3e75a251ebedfd37d2a5ff0c">get_dependency_solvers</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#f51c60a69f3a9dc2bc5afdb2ffaf3990">excuse_unsat_deps</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#f8a6c9adbdec7a5a982dd2b74febcc08">should_remove_source</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#bd18d7acde434387e94344a39db5b0e5">should_upgrade_srcarch</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#94785175a85f44b1afaf3add167a211f">should_upgrade_src</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#be1b4af9d6c6650c70b24267412bc1a8">reversed_exc_deps</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#171969785db449d7a06c3f762774e0cd">invalidate_excuses</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#010f6deffca32f7f71ecf1f5c1bb4985">write_excuses</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="41c5ee0b9d64b2e76a0c1a1c2b28c73e"></a><!-- doxytag: member="britney::Britney::get_nuninst" ref="41c5ee0b9d64b2e76a0c1a1c2b28c73e" args="" -->
def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#41c5ee0b9d64b2e76a0c1a1c2b28c73e">get_nuninst</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e5c18b706e6598474435b1996313cf27"></a><!-- doxytag: member="britney::Britney::eval_nuninst" ref="e5c18b706e6598474435b1996313cf27" args="" -->
def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#e5c18b706e6598474435b1996313cf27">eval_nuninst</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b8dd18ead23b6e1126bb4c2a5c3cd8ba"></a><!-- doxytag: member="britney::Britney::eval_uninst" ref="b8dd18ead23b6e1126bb4c2a5c3cd8ba" args="" -->
def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#b8dd18ead23b6e1126bb4c2a5c3cd8ba">eval_uninst</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="22af61b8a7f6fe71a79d28b5016cae1d"></a><!-- doxytag: member="britney::Britney::doop_source" ref="22af61b8a7f6fe71a79d28b5016cae1d" args="" -->
def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#22af61b8a7f6fe71a79d28b5016cae1d">doop_source</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d453398832baaa7f477f720cfb643029"></a><!-- doxytag: member="britney::Britney::iter_packages" ref="d453398832baaa7f477f720cfb643029" args="" -->
def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#d453398832baaa7f477f720cfb643029">iter_packages</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3ef9b6f600eac492fc5aa4b31638198f"></a><!-- doxytag: member="britney::Britney::do_all" ref="3ef9b6f600eac492fc5aa4b31638198f" args="" -->
def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#3ef9b6f600eac492fc5aa4b31638198f">do_all</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#921effe0d64ed713c38888684a0a26d4">upgrade_testing</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">def&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#0e9551bdf927388f55be5ce15a48c94f">main</a></td></tr>
<tr><td colspan="2"><br><h2>Public Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="07e771f94d4ce224d5677542db25034d"></a><!-- doxytag: member="britney::Britney::selected" ref="07e771f94d4ce224d5677542db25034d" args="" -->
&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#07e771f94d4ce224d5677542db25034d">selected</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d6169c55786a8ec7fb9773170b652da6"></a><!-- doxytag: member="britney::Britney::nuninst_orig" ref="d6169c55786a8ec7fb9773170b652da6" args="" -->
&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#d6169c55786a8ec7fb9773170b652da6">nuninst_orig</a></td></tr>
<tr><td colspan="2"><br><h2>Static Public Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ebbe3f40cca59e2de275b0558556ee63"></a><!-- doxytag: member="britney::Britney::HINTS_STANDARD" ref="ebbe3f40cca59e2de275b0558556ee63" args="" -->
tuple&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#ebbe3f40cca59e2de275b0558556ee63">HINTS_STANDARD</a> = (&quot;easy&quot;, &quot;hint&quot;, &quot;remove&quot;, &quot;block&quot;, &quot;unblock&quot;, &quot;urgent&quot;, &quot;approve&quot;)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a088d6fd96963f87f88c9c40cda10bfa"></a><!-- doxytag: member="britney::Britney::HINTS_ALL" ref="a088d6fd96963f87f88c9c40cda10bfa" args="" -->
tuple&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classbritney_1_1Britney.html#a088d6fd96963f87f88c9c40cda10bfa">HINTS_ALL</a> = (&quot;force&quot;, &quot;force-hint&quot;, &quot;block-all&quot;)</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
<div class="fragment"><pre class="fragment">Britney, the debian testing updater script
This is the script that updates the testing_ distribution. It is executed
each day after the installation of the updated packages. It generates the
`Packages' files for the testing distribution, but it does so in an
intelligent manner; it try to avoid any inconsistency and to use only
non-buggy packages.
For more documentation on this script, please read the Developers Reference.
</pre></div>
<p>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00195">195</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="5846d81eace24f479292c47e30fd1851"></a><!-- doxytag: member="britney::Britney::__init__" ref="5846d81eace24f479292c47e30fd1851" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.__init__ </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Class constructor
This method initializes and populates the data lists, which contain all
the information needed by the other methods of the class.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00201">201</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="f51c60a69f3a9dc2bc5afdb2ffaf3990"></a><!-- doxytag: member="britney::Britney::excuse_unsat_deps" ref="f51c60a69f3a9dc2bc5afdb2ffaf3990" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.excuse_unsat_deps </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>pkg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>arch</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>suite</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>excuse</em> = <code>None</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>excluded</em> = <code>[]</code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Find unsatisfied dependencies for a binary package
This method analyzes the dependencies of the binary package specified
by the parameter `pkg', built from the source package `src', for the
architecture `arch' within the suite `suite'. If the dependency can't
be satisfied in testing and/or unstable, it updates the excuse passed
as parameter.
The dependency fields checked are Pre-Depends and Depends.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00709">709</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="5461f49e3e75a251ebedfd37d2a5ff0c"></a><!-- doxytag: member="britney::Britney::get_dependency_solvers" ref="5461f49e3e75a251ebedfd37d2a5ff0c" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.get_dependency_solvers </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>block</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>arch</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>distribution</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>excluded</em> = <code>[]</code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Find the packages which satisfy a dependency block
This method returns the list of packages which satisfy a dependency
block (as returned by apt_pkg.ParseDepends) for the given architecture
and distribution.
It returns a tuple with two items: the first is a boolean which is
True if the dependency is satisfied, the second is the list of the
solving packages.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00669">669</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="171969785db449d7a06c3f762774e0cd"></a><!-- doxytag: member="britney::Britney::invalidate_excuses" ref="171969785db449d7a06c3f762774e0cd" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.invalidate_excuses </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>valid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>invalid</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Invalidate impossible excuses
This method invalidates the impossible excuses, which depend
on invalid excuses. The two parameters contains the list of
`valid' and `invalid' excuses.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l01112">1112</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="0e9551bdf927388f55be5ce15a48c94f"></a><!-- doxytag: member="britney::Britney::main" ref="0e9551bdf927388f55be5ce15a48c94f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.main </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Main method
This is the entry point for the class: it includes the list of calls
for the member methods which will produce the output files.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l01455">1455</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="5a6af4a100cfd54e872a27fa7f48ac3c"></a><!-- doxytag: member="britney::Britney::normalize_bugs" ref="5a6af4a100cfd54e872a27fa7f48ac3c" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.normalize_bugs </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Normalize the release critical bug summaries for testing and unstable
The method doesn't return any value: it directly modifies the
object attribute `bugs'.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00448">448</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="39248f0cfea1c8798b2ca5a97d37eaf8"></a><!-- doxytag: member="britney::Britney::read_approvals" ref="39248f0cfea1c8798b2ca5a97d37eaf8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.read_approvals </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>basedir</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Read the approval commands from the specified directory
The approval commands are read from the files contained by the
`Approved' directory within the directory specified as `basedir'
parameter. The name of the files has to be the same of the
authorized users for the approvals.
The file contains rows with the format:
&lt;package-name&gt; &lt;version&gt;
The method returns a dictionary where the key is the binary package
name followed by an underscore and the version number, and the value
is the user who submitted the command.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00554">554</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="1b2b0f42e4af1cee472f93e955b30421"></a><!-- doxytag: member="britney::Britney::read_binaries" ref="1b2b0f42e4af1cee472f93e955b30421" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.read_binaries </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>basedir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>distribution</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>arch</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Read the list of binary packages from the specified directory
The binary packages are read from the `Packages_${arch}' files
within the directory specified as `basedir' parameter, replacing
${arch} with the value of the arch parameter. Considering the
large amount of memory needed, not all the fields are loaded
in memory. The available fields are Version, Source, Pre-Depends,
Depends, Conflicts, Provides and Architecture.
After reading the packages, reverse dependencies are computed
and saved in the `rdepends' keys, and the `Provides' field is
used to populate the virtual packages list.
The dependencies are parsed with the apt.pkg.ParseDepends method,
and they are stored both as the format of its return value and
text.
The method returns a tuple. The first element is a list where
every item represents a binary package as a dictionary; the second
element is a dictionary which maps virtual packages to real
packages that provide it.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00317">317</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="6c777aae69e7bec2efebaf23ddd4a86c"></a><!-- doxytag: member="britney::Britney::read_bugs" ref="6c777aae69e7bec2efebaf23ddd4a86c" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.read_bugs </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>basedir</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Read the release critial bug summary from the specified directory
The RC bug summaries are read from the `Bugs' file within the
directory specified as `basedir' parameter. The file contains
rows with the format:
&lt;package-name&gt; &lt;count-of-rc-bugs&gt;
The method returns a dictionary where the key is the binary package
name and the value is the number of open RC bugs for it.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00406">406</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="085af5ac906813ea40fc2e623748f517"></a><!-- doxytag: member="britney::Britney::read_dates" ref="085af5ac906813ea40fc2e623748f517" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.read_dates </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>basedir</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Read the upload date for the packages from the specified directory
The upload dates are read from the `Date' file within the directory
specified as `basedir' parameter. The file contains rows with the
format:
&lt;package-name&gt; &lt;version&gt; &lt;date-of-upload&gt;
The dates are expressed as days starting from the 1970-01-01.
The method returns a dictionary where the key is the binary package
name and the value is tuple with two items, the version and the date.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00483">483</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="46d535f617fcf1faaaf5d841ea23c184"></a><!-- doxytag: member="britney::Britney::read_hints" ref="46d535f617fcf1faaaf5d841ea23c184" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.read_hints </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>basedir</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Read the hint commands from the specified directory
The hint commands are read from the files contained by the `Hints'
directory within the directory specified as `basedir' parameter.
The name of the files has to be the same of the authorized users
for the hints.
The file contains rows with the format:
&lt;command&gt; &lt;package-name&gt;[/&lt;version&gt;]
The method returns a dictionary where the key is the command, and
the value is the list of affected packages.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00580">580</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="054f44c47f17c0c4f5a069e821b7f868"></a><!-- doxytag: member="britney::Britney::read_sources" ref="054f44c47f17c0c4f5a069e821b7f868" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.read_sources </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>basedir</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Read the list of source packages from the specified directory
The source packages are read from the `Sources' file within the
directory specified as `basedir' parameter. Considering the
large amount of memory needed, not all the fields are loaded
in memory. The available fields are Version, Maintainer and Section.
The method returns a list where every item represents a source
package as a dictionary.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00292">292</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="09fc27899506b4830b1961f125a7b6a4"></a><!-- doxytag: member="britney::Britney::read_urgencies" ref="09fc27899506b4830b1961f125a7b6a4" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.read_urgencies </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>basedir</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Read the upload urgency of the packages from the specified directory
The upload urgencies are read from the `Urgency' file within the
directory specified as `basedir' parameter. The file contains rows
with the format:
&lt;package-name&gt; &lt;version&gt; &lt;urgency&gt;
The method returns a dictionary where the key is the binary package
name and the value is the greatest urgency from the versions of the
package that are higher then the testing one.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00509">509</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="be1b4af9d6c6650c70b24267412bc1a8"></a><!-- doxytag: member="britney::Britney::reversed_exc_deps" ref="be1b4af9d6c6650c70b24267412bc1a8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.reversed_exc_deps </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Reverse the excuses dependencies
This method returns a dictionary where the keys are the package names
and the values are the excuse names which depend on it.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l01099">1099</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="85d2e45e8431779b62f398c34972ddf1"></a><!-- doxytag: member="britney::Britney::same_source" ref="85d2e45e8431779b62f398c34972ddf1" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.same_source </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>sv1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>sv2</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Check if two version numbers are built from the same source
This method returns a boolean value which is true if the two
version numbers specified as parameters are built from the same
source. The main use of this code is to detect binary-NMU.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00630">630</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="f8a6c9adbdec7a5a982dd2b74febcc08"></a><!-- doxytag: member="britney::Britney::should_remove_source" ref="f8a6c9adbdec7a5a982dd2b74febcc08" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.should_remove_source </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>pkg</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Check if a source package should be removed from testing
This method checks if a source package should be removed from the
testing distribution; this happen if the source package is not
present in the unstable distribution anymore.
It returns True if the package can be removed, False otherwise.
In the former case, a new excuse is appended to the the object
attribute excuses.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00765">765</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="94785175a85f44b1afaf3add167a211f"></a><!-- doxytag: member="britney::Britney::should_upgrade_src" ref="94785175a85f44b1afaf3add167a211f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.should_upgrade_src </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>suite</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Check if source package should be upgraded
This method checks if a source package should be upgraded. The analisys
is performed for the source package specified by the `src' parameter,
checking the architecture `arch' for the distribution `suite'.
It returns False if the given package doesn't need to be upgraded,
True otherwise. In the former case, a new excuse is appended to
the the object attribute excuses.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00903">903</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="bd18d7acde434387e94344a39db5b0e5"></a><!-- doxytag: member="britney::Britney::should_upgrade_srcarch" ref="bd18d7acde434387e94344a39db5b0e5" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.should_upgrade_srcarch </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>arch</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>suite</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Check if binary package should be upgraded
This method checks if a binary package should be upgraded; this can
happen also if the binary package is a binary-NMU for the given arch.
The analisys is performed for the source package specified by the
`src' parameter, checking the architecture `arch' for the distribution
`suite'.
It returns False if the given package doesn't need to be upgraded,
True otherwise. In the former case, a new excuse is appended to
the the object attribute excuses.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l00789">789</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="921effe0d64ed713c38888684a0a26d4"></a><!-- doxytag: member="britney::Britney::upgrade_testing" ref="921effe0d64ed713c38888684a0a26d4" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.upgrade_testing </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Upgrade testing using the unstable packages
This method tries to upgrade testing using the packages from unstable.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l01438">1438</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<a class="anchor" name="010f6deffca32f7f71ecf1f5c1bb4985"></a><!-- doxytag: member="britney::Britney::write_excuses" ref="010f6deffca32f7f71ecf1f5c1bb4985" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">def britney.Britney.write_excuses </td>
<td>(</td>
<td class="paramtype">&nbsp;</td>
<td class="paramname"> <em>self</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<div class="fragment"><pre class="fragment">Produce and write the update excuses
This method handles the update excuses generation: the packages are
looked to determine whether they are valid candidates. For the details
of this procedure, please refer to the module docstring.
</pre></div>
<p>
Definition at line <a class="el" href="britney_8py-source.html#l01154">1154</a> of file <a class="el" href="britney_8py-source.html">britney.py</a>.
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="britney_8py-source.html">britney.py</a></ul>
<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>