<html><head><title>/home/phd/current/SQLObject/SQLObject/sqlobject/declarative.py</title>
<script type="text/javascript"><!--
function show_line_range() {
var href = document.location.href;
if (href.indexOf('?') == -1) {
return;
}
var qs = href.substring(href.indexOf('?')+1);
if (qs.indexOf('#') >= 0) {
qs = qs.substring(0, qs.indexOf('#'));
}
var first = qs.match(/f=(\d+)/)[1];
var last = qs.match(/l=(\d+)/)[1];
if (! first || ! last) {
return;
}
var anchors = document.getElementsByTagName('A');
var container = document.createElement('DIV');
container.className = 'highlighted';
var children = [];
var start = null;
var parent = null;
var highlight = false;
for (var i = 0; i < anchors.length; i++) {
var el = anchors[i];
if (el.getAttribute('name') == first) {
start = el.previousSibling;
parent = el.parentNode;
highlight = true;
}
if (el.getAttribute('name') == last) {
break;
}
if (highlight) {
children[children.length] = el;
el = el.nextSibling;
while (el && el.tagName != 'A') {
children[children.length] = el;
el = el.nextSibling;
}
}
}
for (i=0; i<children.length; i++) {
container.appendChild(children[i]);
}
if (start) {
start.parentNode.insertBefore(container, start.nextSibling);
} else {
parent.insertBefore(container, parent.childNodes[0]);
}
}
// --></script>
<style>
div.python {
color: #333
}
div.python a.lnum {
color: #555;
background-color: #eee;
border-right: 1px solid #999;
padding-right: 2px;
margin-right: 4px;
}
div.python span.comment { color: #933 }
div.python span.keyword { color: #a3e; font-weight: bold }
div.python span.op { color: #c96 }
div.python span.string { color: #6a6 }
div.python span.name { }
div.python span.text { color: #333 }
div.highlighted { background-color: #ff9; border: 1px solid #009 }
</style></head><body onload="show_line_range()"><div class="python"><code><a class="lnum" href="#1" name="1">0001</a><span class="string">"""</span><br />
<a class="lnum" href="#2" name="2">0002</a><span class="string">Declarative objects.</span><br />
<a class="lnum" href="#3" name="3">0003</a><span class="string"></span><br />
<a class="lnum" href="#4" name="4">0004</a><span class="string">Declarative objects have a simple protocol: you can use classes in</span><br />
<a class="lnum" href="#5" name="5">0005</a><span class="string">lieu of instances and they are equivalent, and any keyword arguments</span><br />
<a class="lnum" href="#6" name="6">0006</a><span class="string">you give to the constructor will override those instance variables.</span><br />
<a class="lnum" href="#7" name="7">0007</a><span class="string">(So if a class is received, we'll simply instantiate an instance with</span><br />
<a class="lnum" href="#8" name="8">0008</a><span class="string">no arguments).</span><br />
<a class="lnum" href="#9" name="9">0009</a><span class="string"></span><br />
<a class="lnum" href="#10" name="10">0010</a><span class="string">You can provide a variable __unpackargs__ (a list of strings), and if</span><br />
<a class="lnum" href="#11" name="11">0011</a><span class="string">the constructor is called with non-keyword arguments they will be</span><br />
<a class="lnum" href="#12" name="12">0012</a><span class="string">interpreted as the given keyword arguments.</span><br />
<a class="lnum" href="#13" name="13">0013</a><span class="string"></span><br />
<a class="lnum" href="#14" name="14">0014</a><span class="string">If __unpackargs__ is ('*', name), then all the arguments will be put</span><br />
<a class="lnum" href="#15" name="15">0015</a><span class="string">in a variable by that name.</span><br />
<a class="lnum" href="#16" name="16">0016</a><span class="string"></span><br />
<a class="lnum" href="#17" name="17">0017</a><span class="string">You can define a __classinit__(cls, new_attrs) method, which will be</span><br />
<a class="lnum" href="#18" name="18">0018</a><span class="string">called when the class is created (including subclasses).  Note: you</span><br />
<a class="lnum" href="#19" name="19">0019</a><span class="string">can't use super() in __classinit__ because the class isn't bound to a</span><br />
<a class="lnum" href="#20" name="20">0020</a><span class="string">name.  As an analog to __classinit__, Declarative adds</span><br />
<a class="lnum" href="#21" name="21">0021</a><span class="string">__instanceinit__ which is called with the same argument (new_attrs).</span><br />
<a class="lnum" href="#22" name="22">0022</a><span class="string">This is like __init__, but after __unpackargs__ and other factors have</span><br />
<a class="lnum" href="#23" name="23">0023</a><span class="string">been taken into account.</span><br />
<a class="lnum" href="#24" name="24">0024</a><span class="string"></span><br />
<a class="lnum" href="#25" name="25">0025</a><span class="string">If __mutableattributes__ is defined as a sequence of strings, these</span><br />
<a class="lnum" href="#26" name="26">0026</a><span class="string">attributes will not be shared between superclasses and their</span><br />
<a class="lnum" href="#27" name="27">0027</a><span class="string">subclasses.  E.g., if you have a class variable that contains a list</span><br />
<a class="lnum" href="#28" name="28">0028</a><span class="string">and you append to that list, changes to subclasses will effect</span><br />
<a class="lnum" href="#29" name="29">0029</a><span class="string">superclasses unless you add the attribute here.</span><br />
<a class="lnum" href="#30" name="30">0030</a><span class="string"></span><br />
<a class="lnum" href="#31" name="31">0031</a><span class="string">Also defines classinstancemethod, which acts as either a class method</span><br />
<a class="lnum" href="#32" name="32">0032</a><span class="string">or an instance method depending on where it is called.</span><br />
<a class="lnum" href="#33" name="33">0033</a><span class="string">"""</span><br />
<a class="lnum" href="#34" name="34">0034</a><br />
<a class="lnum" href="#35" name="35">0035</a><span class="keyword">import</span> <span class="name">copy</span><br />
<a class="lnum" href="#36" name="36">0036</a><span class="keyword">import</span> <span class="name">events</span><br />
<a class="lnum" href="#37" name="37">0037</a><br />
<a class="lnum" href="#38" name="38">0038</a><span class="keyword">import</span> <span class="name">itertools</span><br />
<a class="lnum" href="#39" name="39">0039</a><span class="name">counter</span> <span class="op">=</span> <span class="name">itertools</span><span class="op">.</span><span class="name">count</span><span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#40" name="40">0040</a><br />
<a class="lnum" href="#41" name="41">0041</a><span class="name">__all__</span> <span class="op">=</span> <span class="op">(</span><span class="string">'classinstancemethod'</span><span class="op">,</span> <span class="string">'DeclarativeMeta'</span><span class="op">,</span> <span class="string">'Declarative'</span><span class="op">)</span><br />
<a class="lnum" href="#42" name="42">0042</a><br />
<a class="lnum" href="#43" name="43">0043</a><br />
<a class="lnum" href="#44" name="44">0044</a><span class="keyword">class</span> <span class="name">classinstancemethod</span><span class="op">(</span><span class="name">object</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#45" name="45">0045</a>    <span class="string">"""</span><br />
<a class="lnum" href="#46" name="46">0046</a><span class="string">    Acts like a class method when called from a class, like an</span><br />
<a class="lnum" href="#47" name="47">0047</a><span class="string">    instance method when called by an instance.  The method should</span><br />
<a class="lnum" href="#48" name="48">0048</a><span class="string">    take two arguments, 'self' and 'cls'; one of these will be None</span><br />
<a class="lnum" href="#49" name="49">0049</a><span class="string">    depending on how the method was called.</span><br />
<a class="lnum" href="#50" name="50">0050</a><span class="string">    """</span><br />
<a class="lnum" href="#51" name="51">0051</a><br />
<a class="lnum" href="#52" name="52">0052</a>    <span class="keyword">def</span> <span class="name">__init__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="name">func</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#53" name="53">0053</a>        <span class="name">self</span><span class="op">.</span><span class="name">func</span> <span class="op">=</span> <span class="name">func</span><br />
<a class="lnum" href="#54" name="54">0054</a><br />
<a class="lnum" href="#55" name="55">0055</a>    <span class="keyword">def</span> <span class="name">__get__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="name">obj</span><span class="op">,</span> <span class="name">type</span><span class="op">=</span><span class="name">None</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#56" name="56">0056</a>        <span class="keyword">return</span> <span class="name">_methodwrapper</span><span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">func</span><span class="op">,</span> <span class="name">obj</span><span class="op">=</span><span class="name">obj</span><span class="op">,</span> <span class="name">type</span><span class="op">=</span><span class="name">type</span><span class="op">)</span><br />
<a class="lnum" href="#57" name="57">0057</a><br />
<a class="lnum" href="#58" name="58">0058</a><span class="keyword">class</span> <span class="name">_methodwrapper</span><span class="op">(</span><span class="name">object</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#59" name="59">0059</a><br />
<a class="lnum" href="#60" name="60">0060</a>    <span class="keyword">def</span> <span class="name">__init__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="name">func</span><span class="op">,</span> <span class="name">obj</span><span class="op">,</span> <span class="name">type</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#61" name="61">0061</a>        <span class="name">self</span><span class="op">.</span><span class="name">func</span> <span class="op">=</span> <span class="name">func</span><br />
<a class="lnum" href="#62" name="62">0062</a>        <span class="name">self</span><span class="op">.</span><span class="name">obj</span> <span class="op">=</span> <span class="name">obj</span><br />
<a class="lnum" href="#63" name="63">0063</a>        <span class="name">self</span><span class="op">.</span><span class="name">type</span> <span class="op">=</span> <span class="name">type</span><br />
<a class="lnum" href="#64" name="64">0064</a><br />
<a class="lnum" href="#65" name="65">0065</a>    <span class="keyword">def</span> <span class="name">__call__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="op">*</span><span class="name">args</span><span class="op">,</span> <span class="op">**</span><span class="name">kw</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#66" name="66">0066</a>        <span class="keyword">assert</span> <span class="keyword">not</span> <span class="string">'self'</span> <span class="keyword">in</span> <span class="name">kw</span> <span class="keyword">and</span> <span class="keyword">not</span> <span class="string">'cls'</span> <span class="keyword">in</span> <span class="name">kw</span><span class="op">,</span> <span class="op">(</span><br />
<a class="lnum" href="#67" name="67">0067</a>            <span class="string">"You cannot use 'self' or 'cls' arguments to a "</span><br />
<a class="lnum" href="#68" name="68">0068</a>            <span class="string">"classinstancemethod"</span><span class="op">)</span><br />
<a class="lnum" href="#69" name="69">0069</a>        <span class="keyword">return</span> <span class="name">self</span><span class="op">.</span><span class="name">func</span><span class="op">(</span><span class="op">*</span><span class="op">(</span><span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">obj</span><span class="op">,</span> <span class="name">self</span><span class="op">.</span><span class="name">type</span><span class="op">)</span> <span class="op">+</span> <span class="name">args</span><span class="op">)</span><span class="op">,</span> <span class="op">**</span><span class="name">kw</span><span class="op">)</span><br />
<a class="lnum" href="#70" name="70">0070</a><br />
<a class="lnum" href="#71" name="71">0071</a>    <span class="keyword">def</span> <span class="name">__repr__</span><span class="op">(</span><span class="name">self</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#72" name="72">0072</a>        <span class="keyword">if</span> <span class="name">self</span><span class="op">.</span><span class="name">obj</span> <span class="keyword">is</span> <span class="name">None</span><span class="op">:</span><br />
<a class="lnum" href="#73" name="73">0073</a>            <span class="keyword">return</span> <span class="op">(</span><span class="string">'<bound class method %s.%s>'</span><br />
<a class="lnum" href="#74" name="74">0074</a>                    <span class="op">%</span> <span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">type</span><span class="op">.</span><span class="name">__name__</span><span class="op">,</span> <span class="name">self</span><span class="op">.</span><span class="name">func</span><span class="op">.</span><span class="name">func_name</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#75" name="75">0075</a>        <span class="keyword">else</span><span class="op">:</span><br />
<a class="lnum" href="#76" name="76">0076</a>            <span class="keyword">return</span> <span class="op">(</span><span class="string">'<bound method %s.%s of %r>'</span><br />
<a class="lnum" href="#77" name="77">0077</a>                    <span class="op">%</span> <span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">type</span><span class="op">.</span><span class="name">__name__</span><span class="op">,</span> <span class="name">self</span><span class="op">.</span><span class="name">func</span><span class="op">.</span><span class="name">func_name</span><span class="op">,</span> <span class="name">self</span><span class="op">.</span><span class="name">obj</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#78" name="78">0078</a><br />
<a class="lnum" href="#79" name="79">0079</a><span class="keyword">class</span> <span class="name">DeclarativeMeta</span><span class="op">(</span><span class="name">type</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#80" name="80">0080</a><br />
<a class="lnum" href="#81" name="81">0081</a>    <span class="keyword">def</span> <span class="name">__new__</span><span class="op">(</span><span class="name">meta</span><span class="op">,</span> <span class="name">class_name</span><span class="op">,</span> <span class="name">bases</span><span class="op">,</span> <span class="name">new_attrs</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#82" name="82">0082</a>        <span class="name">post_funcs</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span><br />
<a class="lnum" href="#83" name="83">0083</a>        <span class="name">early_funcs</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span><br />
<a class="lnum" href="#84" name="84">0084</a>        <span class="name">events</span><span class="op">.</span><span class="name">send</span><span class="op">(</span><span class="name">events</span><span class="op">.</span><span class="name">ClassCreateSignal</span><span class="op">,</span><br />
<a class="lnum" href="#85" name="85">0085</a>                    <span class="name">bases</span><span class="op">[</span><span class="number">0</span><span class="op">]</span><span class="op">,</span> <span class="name">class_name</span><span class="op">,</span> <span class="name">bases</span><span class="op">,</span> <span class="name">new_attrs</span><span class="op">,</span><br />
<a class="lnum" href="#86" name="86">0086</a>                    <span class="name">post_funcs</span><span class="op">,</span> <span class="name">early_funcs</span><span class="op">)</span><br />
<a class="lnum" href="#87" name="87">0087</a>        <span class="name">cls</span> <span class="op">=</span> <span class="name">type</span><span class="op">.</span><span class="name">__new__</span><span class="op">(</span><span class="name">meta</span><span class="op">,</span> <span class="name">class_name</span><span class="op">,</span> <span class="name">bases</span><span class="op">,</span> <span class="name">new_attrs</span><span class="op">)</span><br />
<a class="lnum" href="#88" name="88">0088</a>        <span class="keyword">for</span> <span class="name">func</span> <span class="keyword">in</span> <span class="name">early_funcs</span><span class="op">:</span><br />
<a class="lnum" href="#89" name="89">0089</a>            <span class="name">func</span><span class="op">(</span><span class="name">cls</span><span class="op">)</span><br />
<a class="lnum" href="#90" name="90">0090</a>        <span class="keyword">if</span> <span class="string">'__classinit__'</span> <span class="keyword">in</span> <span class="name">new_attrs</span><span class="op">:</span><br />
<a class="lnum" href="#91" name="91">0091</a>            <span class="name">cls</span><span class="op">.</span><span class="name">__classinit__</span> <span class="op">=</span> <span class="name">staticmethod</span><span class="op">(</span><span class="name">cls</span><span class="op">.</span><span class="name">__classinit__</span><span class="op">.</span><span class="name">im_func</span><span class="op">)</span><br />
<a class="lnum" href="#92" name="92">0092</a>        <span class="name">cls</span><span class="op">.</span><span class="name">__classinit__</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">new_attrs</span><span class="op">)</span><br />
<a class="lnum" href="#93" name="93">0093</a>        <span class="keyword">for</span> <span class="name">func</span> <span class="keyword">in</span> <span class="name">post_funcs</span><span class="op">:</span><br />
<a class="lnum" href="#94" name="94">0094</a>            <span class="name">func</span><span class="op">(</span><span class="name">cls</span><span class="op">)</span><br />
<a class="lnum" href="#95" name="95">0095</a>        <span class="keyword">return</span> <span class="name">cls</span><br />
<a class="lnum" href="#96" name="96">0096</a><br />
<a class="lnum" href="#97" name="97">0097</a><span class="keyword">class</span> <span class="name">Declarative</span><span class="op">(</span><span class="name">object</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#98" name="98">0098</a><br />
<a class="lnum" href="#99" name="99">0099</a>    <span class="name">__unpackargs__</span> <span class="op">=</span> <span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#100" name="100">0100</a><br />
<a class="lnum" href="#101" name="101">0101</a>    <span class="name">__mutableattributes__</span> <span class="op">=</span> <span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#102" name="102">0102</a><br />
<a class="lnum" href="#103" name="103">0103</a>    <span class="name">__metaclass__</span> <span class="op">=</span> <span class="name">DeclarativeMeta</span><br />
<a class="lnum" href="#104" name="104">0104</a><br />
<a class="lnum" href="#105" name="105">0105</a>    <span class="name">__restrict_attributes__</span> <span class="op">=</span> <span class="name">None</span><br />
<a class="lnum" href="#106" name="106">0106</a><br />
<a class="lnum" href="#107" name="107">0107</a>    <span class="keyword">def</span> <span class="name">__classinit__</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">new_attrs</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#108" name="108">0108</a>        <span class="name">cls</span><span class="op">.</span><span class="name">declarative_count</span> <span class="op">=</span> <span class="name">counter</span><span class="op">.</span><span class="name">next</span><span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#109" name="109">0109</a>        <span class="keyword">for</span> <span class="name">name</span> <span class="keyword">in</span> <span class="name">cls</span><span class="op">.</span><span class="name">__mutableattributes__</span><span class="op">:</span><br />
<a class="lnum" href="#110" name="110">0110</a>            <span class="keyword">if</span> <span class="name">name</span> <span class="keyword">not</span> <span class="keyword">in</span> <span class="name">new_attrs</span><span class="op">:</span><br />
<a class="lnum" href="#111" name="111">0111</a>                <span class="name">setattr</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">copy</span><span class="op">.</span><span class="name">copy</span><span class="op">(</span><span class="name">getattr</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">name</span><span class="op">)</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#112" name="112">0112</a><br />
<a class="lnum" href="#113" name="113">0113</a>    <span class="keyword">def</span> <span class="name">__instanceinit__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="name">new_attrs</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#114" name="114">0114</a>        <span class="keyword">if</span> <span class="name">self</span><span class="op">.</span><span class="name">__restrict_attributes__</span> <span class="keyword">is</span> <span class="keyword">not</span> <span class="name">None</span><span class="op">:</span><br />
<a class="lnum" href="#115" name="115">0115</a>            <span class="keyword">for</span> <span class="name">name</span> <span class="keyword">in</span> <span class="name">new_attrs</span><span class="op">:</span><br />
<a class="lnum" href="#116" name="116">0116</a>                <span class="keyword">if</span> <span class="name">name</span> <span class="keyword">not</span> <span class="keyword">in</span> <span class="name">self</span><span class="op">.</span><span class="name">__restrict_attributes__</span><span class="op">:</span><br />
<a class="lnum" href="#117" name="117">0117</a>                    <span class="keyword">raise</span> <span class="name">TypeError</span><span class="op">(</span><br />
<a class="lnum" href="#118" name="118">0118</a>                        <span class="string">'%s() got an unexpected keyword argument %r'</span><br />
<a class="lnum" href="#119" name="119">0119</a>                        <span class="op">%</span> <span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">__class__</span><span class="op">.</span><span class="name">__name__</span><span class="op">,</span> <span class="name">name</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#120" name="120">0120</a>        <span class="keyword">for</span> <span class="name">name</span><span class="op">,</span> <span class="name">value</span> <span class="keyword">in</span> <span class="name">new_attrs</span><span class="op">.</span><span class="name">items</span><span class="op">(</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#121" name="121">0121</a>            <span class="name">setattr</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="name">name</span><span class="op">,</span> <span class="name">value</span><span class="op">)</span><br />
<a class="lnum" href="#122" name="122">0122</a>        <span class="keyword">if</span> <span class="string">'declarative_count'</span> <span class="keyword">not</span> <span class="keyword">in</span> <span class="name">new_attrs</span><span class="op">:</span><br />
<a class="lnum" href="#123" name="123">0123</a>            <span class="name">self</span><span class="op">.</span><span class="name">declarative_count</span> <span class="op">=</span> <span class="name">counter</span><span class="op">.</span><span class="name">next</span><span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#124" name="124">0124</a><br />
<a class="lnum" href="#125" name="125">0125</a>    <span class="keyword">def</span> <span class="name">__init__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="op">*</span><span class="name">args</span><span class="op">,</span> <span class="op">**</span><span class="name">kw</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#126" name="126">0126</a>        <span class="keyword">if</span> <span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span> <span class="keyword">and</span> <span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span><span class="op">[</span><span class="number">0</span><span class="op">]</span> <span class="op">==</span> <span class="string">'*'</span><span class="op">:</span><br />
<a class="lnum" href="#127" name="127">0127</a>            <span class="keyword">assert</span> <span class="name">len</span><span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span><span class="op">)</span> <span class="op">==</span> <span class="number">2</span><span class="op">,</span>                      <span class="string">"When using __unpackargs__ = ('*', varname), you must only provide a single variable name (you gave %r)"</span> <span class="op">%</span> <span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span><br />
<a class="lnum" href="#129" name="129">0129</a>            <span class="name">name</span> <span class="op">=</span> <span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span><span class="op">[</span><span class="number">1</span><span class="op">]</span><br />
<a class="lnum" href="#130" name="130">0130</a>            <span class="keyword">if</span> <span class="name">name</span> <span class="keyword">in</span> <span class="name">kw</span><span class="op">:</span><br />
<a class="lnum" href="#131" name="131">0131</a>                <span class="keyword">raise</span> <span class="name">TypeError</span><span class="op">(</span><br />
<a class="lnum" href="#132" name="132">0132</a>                    <span class="string">"keyword parameter '%s' was given by position and name"</span><br />
<a class="lnum" href="#133" name="133">0133</a>                    <span class="op">%</span> <span class="name">name</span><span class="op">)</span><br />
<a class="lnum" href="#134" name="134">0134</a>            <span class="name">kw</span><span class="op">[</span><span class="name">name</span><span class="op">]</span> <span class="op">=</span> <span class="name">args</span><br />
<a class="lnum" href="#135" name="135">0135</a>        <span class="keyword">else</span><span class="op">:</span><br />
<a class="lnum" href="#136" name="136">0136</a>            <span class="keyword">if</span> <span class="name">len</span><span class="op">(</span><span class="name">args</span><span class="op">)</span> <span class="op">></span> <span class="name">len</span><span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#137" name="137">0137</a>                <span class="keyword">raise</span> <span class="name">TypeError</span><span class="op">(</span><br />
<a class="lnum" href="#138" name="138">0138</a>                    <span class="string">'%s() takes at most %i arguments (%i given)'</span><br />
<a class="lnum" href="#139" name="139">0139</a>                    <span class="op">%</span> <span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">__class__</span><span class="op">.</span><span class="name">__name__</span><span class="op">,</span><br />
<a class="lnum" href="#140" name="140">0140</a>                       <span class="name">len</span><span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span><span class="op">)</span><span class="op">,</span><br />
<a class="lnum" href="#141" name="141">0141</a>                       <span class="name">len</span><span class="op">(</span><span class="name">args</span><span class="op">)</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#142" name="142">0142</a>            <span class="keyword">for</span> <span class="name">name</span><span class="op">,</span> <span class="name">arg</span> <span class="keyword">in</span> <span class="name">zip</span><span class="op">(</span><span class="name">self</span><span class="op">.</span><span class="name">__unpackargs__</span><span class="op">,</span> <span class="name">args</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#143" name="143">0143</a>                <span class="keyword">if</span> <span class="name">name</span> <span class="keyword">in</span> <span class="name">kw</span><span class="op">:</span><br />
<a class="lnum" href="#144" name="144">0144</a>                    <span class="keyword">raise</span> <span class="name">TypeError</span><span class="op">(</span><br />
<a class="lnum" href="#145" name="145">0145</a>                        <span class="string">"keyword parameter '%s' was given by position and name"</span><br />
<a class="lnum" href="#146" name="146">0146</a>                        <span class="op">%</span> <span class="name">name</span><span class="op">)</span><br />
<a class="lnum" href="#147" name="147">0147</a>                <span class="name">kw</span><span class="op">[</span><span class="name">name</span><span class="op">]</span> <span class="op">=</span> <span class="name">arg</span><br />
<a class="lnum" href="#148" name="148">0148</a>        <span class="keyword">if</span> <span class="string">'__alsocopy'</span> <span class="keyword">in</span> <span class="name">kw</span><span class="op">:</span><br />
<a class="lnum" href="#149" name="149">0149</a>            <span class="keyword">for</span> <span class="name">name</span><span class="op">,</span> <span class="name">value</span> <span class="keyword">in</span> <span class="name">kw</span><span class="op">[</span><span class="string">'__alsocopy'</span><span class="op">]</span><span class="op">.</span><span class="name">items</span><span class="op">(</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#150" name="150">0150</a>                <span class="keyword">if</span> <span class="name">name</span> <span class="keyword">not</span> <span class="keyword">in</span> <span class="name">kw</span><span class="op">:</span><br />
<a class="lnum" href="#151" name="151">0151</a>                    <span class="keyword">if</span> <span class="name">name</span> <span class="keyword">in</span> <span class="name">self</span><span class="op">.</span><span class="name">__mutableattributes__</span><span class="op">:</span><br />
<a class="lnum" href="#152" name="152">0152</a>                        <span class="name">value</span> <span class="op">=</span> <span class="name">copy</span><span class="op">.</span><span class="name">copy</span><span class="op">(</span><span class="name">value</span><span class="op">)</span><br />
<a class="lnum" href="#153" name="153">0153</a>                    <span class="name">kw</span><span class="op">[</span><span class="name">name</span><span class="op">]</span> <span class="op">=</span> <span class="name">value</span><br />
<a class="lnum" href="#154" name="154">0154</a>            <span class="keyword">del</span> <span class="name">kw</span><span class="op">[</span><span class="string">'__alsocopy'</span><span class="op">]</span><br />
<a class="lnum" href="#155" name="155">0155</a>        <span class="name">self</span><span class="op">.</span><span class="name">__instanceinit__</span><span class="op">(</span><span class="name">kw</span><span class="op">)</span><br />
<a class="lnum" href="#156" name="156">0156</a><br />
<a class="lnum" href="#157" name="157">0157</a>    <span class="keyword">def</span> <span class="name">__call__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="op">*</span><span class="name">args</span><span class="op">,</span> <span class="op">**</span><span class="name">kw</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#158" name="158">0158</a>        <span class="name">kw</span><span class="op">[</span><span class="string">'__alsocopy'</span><span class="op">]</span> <span class="op">=</span> <span class="name">self</span><span class="op">.</span><span class="name">__dict__</span><br />
<a class="lnum" href="#159" name="159">0159</a>        <span class="keyword">return</span> <span class="name">self</span><span class="op">.</span><span class="name">__class__</span><span class="op">(</span><span class="op">*</span><span class="name">args</span><span class="op">,</span> <span class="op">**</span><span class="name">kw</span><span class="op">)</span><br />
<a class="lnum" href="#160" name="160">0160</a><br />
<a class="lnum" href="#161" name="161">0161</a>    <span class="op">@</span><span class="name">classinstancemethod</span><br />
<a class="lnum" href="#162" name="162">0162</a>    <span class="keyword">def</span> <span class="name">singleton</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="name">cls</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#163" name="163">0163</a>        <span class="keyword">if</span> <span class="name">self</span><span class="op">:</span><br />
<a class="lnum" href="#164" name="164">0164</a>            <span class="keyword">return</span> <span class="name">self</span><br />
<a class="lnum" href="#165" name="165">0165</a>        <span class="name">name</span> <span class="op">=</span> <span class="string">'_%s__singleton'</span> <span class="op">%</span> <span class="name">cls</span><span class="op">.</span><span class="name">__name__</span><br />
<a class="lnum" href="#166" name="166">0166</a>        <span class="keyword">if</span> <span class="keyword">not</span> <span class="name">hasattr</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">name</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#167" name="167">0167</a>            <span class="name">setattr</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">name</span><span class="op">,</span> <span class="name">cls</span><span class="op">(</span><span class="name">declarative_count</span><span class="op">=</span><span class="name">cls</span><span class="op">.</span><span class="name">declarative_count</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#168" name="168">0168</a>        <span class="keyword">return</span> <span class="name">getattr</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">name</span><span class="op">)</span><br />
<a class="lnum" href="#169" name="169">0169</a><br />
<a class="lnum" href="#170" name="170">0170</a>    <span class="op">@</span><span class="name">classinstancemethod</span><br />
<a class="lnum" href="#171" name="171">0171</a>    <span class="keyword">def</span> <span class="name">__repr__</span><span class="op">(</span><span class="name">self</span><span class="op">,</span> <span class="name">cls</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#172" name="172">0172</a>        <span class="keyword">if</span> <span class="name">self</span><span class="op">:</span><br />
<a class="lnum" href="#173" name="173">0173</a>            <span class="name">name</span> <span class="op">=</span> <span class="string">'%s object'</span> <span class="op">%</span> <span class="name">self</span><span class="op">.</span><span class="name">__class__</span><span class="op">.</span><span class="name">__name__</span><br />
<a class="lnum" href="#174" name="174">0174</a>            <span class="name">v</span> <span class="op">=</span> <span class="name">self</span><span class="op">.</span><span class="name">__dict__</span><span class="op">.</span><span class="name">copy</span><span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#175" name="175">0175</a>        <span class="keyword">else</span><span class="op">:</span><br />
<a class="lnum" href="#176" name="176">0176</a>            <span class="name">name</span> <span class="op">=</span> <span class="string">'%s class'</span> <span class="op">%</span> <span class="name">cls</span><span class="op">.</span><span class="name">__name__</span><br />
<a class="lnum" href="#177" name="177">0177</a>            <span class="name">v</span> <span class="op">=</span> <span class="name">cls</span><span class="op">.</span><span class="name">__dict__</span><span class="op">.</span><span class="name">copy</span><span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#178" name="178">0178</a>        <span class="keyword">if</span> <span class="string">'declarative_count'</span> <span class="keyword">in</span> <span class="name">v</span><span class="op">:</span><br />
<a class="lnum" href="#179" name="179">0179</a>            <span class="name">name</span> <span class="op">=</span> <span class="string">'%s %i'</span> <span class="op">%</span> <span class="op">(</span><span class="name">name</span><span class="op">,</span> <span class="name">v</span><span class="op">[</span><span class="string">'declarative_count'</span><span class="op">]</span><span class="op">)</span><br />
<a class="lnum" href="#180" name="180">0180</a>            <span class="keyword">del</span> <span class="name">v</span><span class="op">[</span><span class="string">'declarative_count'</span><span class="op">]</span><br />
<a class="lnum" href="#181" name="181">0181</a>        <span class="comment"># @@: simplifying repr:</span><br />
<a class="lnum" href="#182" name="182">0182</a>        <span class="comment">#v = {}</span><br />
<a class="lnum" href="#183" name="183">0183</a>        <span class="name">names</span> <span class="op">=</span> <span class="name">v</span><span class="op">.</span><span class="name">keys</span><span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#184" name="184">0184</a>        <span class="name">args</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span><br />
<a class="lnum" href="#185" name="185">0185</a>        <span class="keyword">for</span> <span class="name">n</span> <span class="keyword">in</span> <span class="name">self</span><span class="op">.</span><span class="name">_repr_vars</span><span class="op">(</span><span class="name">names</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#186" name="186">0186</a>            <span class="name">args</span><span class="op">.</span><span class="name">append</span><span class="op">(</span><span class="string">'%s=%r'</span> <span class="op">%</span> <span class="op">(</span><span class="name">n</span><span class="op">,</span> <span class="name">v</span><span class="op">[</span><span class="name">n</span><span class="op">]</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#187" name="187">0187</a>        <span class="keyword">if</span> <span class="keyword">not</span> <span class="name">args</span><span class="op">:</span><br />
<a class="lnum" href="#188" name="188">0188</a>            <span class="keyword">return</span> <span class="string">'<%s>'</span> <span class="op">%</span> <span class="name">name</span><br />
<a class="lnum" href="#189" name="189">0189</a>        <span class="keyword">else</span><span class="op">:</span><br />
<a class="lnum" href="#190" name="190">0190</a>            <span class="keyword">return</span> <span class="string">'<%s %s>'</span> <span class="op">%</span> <span class="op">(</span><span class="name">name</span><span class="op">,</span> <span class="string">' '</span><span class="op">.</span><span class="name">join</span><span class="op">(</span><span class="name">args</span><span class="op">)</span><span class="op">)</span><br />
<a class="lnum" href="#191" name="191">0191</a><br />
<a class="lnum" href="#192" name="192">0192</a>    <span class="op">@</span><span class="name">staticmethod</span><br />
<a class="lnum" href="#193" name="193">0193</a>    <span class="keyword">def</span> <span class="name">_repr_vars</span><span class="op">(</span><span class="name">dictNames</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#194" name="194">0194</a>        <span class="name">names</span> <span class="op">=</span> <span class="op">[</span><span class="name">n</span> <span class="keyword">for</span> <span class="name">n</span> <span class="keyword">in</span> <span class="name">dictNames</span><br />
<a class="lnum" href="#195" name="195">0195</a>                 <span class="keyword">if</span> <span class="keyword">not</span> <span class="name">n</span><span class="op">.</span><span class="name">startswith</span><span class="op">(</span><span class="string">'_'</span><span class="op">)</span><br />
<a class="lnum" href="#196" name="196">0196</a>                 <span class="keyword">and</span> <span class="name">n</span> <span class="op">!=</span> <span class="string">'declarative_count'</span><span class="op">]</span><br />
<a class="lnum" href="#197" name="197">0197</a>        <span class="name">names</span><span class="op">.</span><span class="name">sort</span><span class="op">(</span><span class="op">)</span><br />
<a class="lnum" href="#198" name="198">0198</a>        <span class="keyword">return</span> <span class="name">names</span><br />
<a class="lnum" href="#199" name="199">0199</a><br />
<a class="lnum" href="#200" name="200">0200</a><span class="keyword">def</span> <span class="name">setup_attributes</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">new_attrs</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#201" name="201">0201</a>    <span class="keyword">for</span> <span class="name">name</span><span class="op">,</span> <span class="name">value</span> <span class="keyword">in</span> <span class="name">new_attrs</span><span class="op">.</span><span class="name">items</span><span class="op">(</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#202" name="202">0202</a>        <span class="keyword">if</span> <span class="name">hasattr</span><span class="op">(</span><span class="name">value</span><span class="op">,</span> <span class="string">'__addtoclass__'</span><span class="op">)</span><span class="op">:</span><br />
<a class="lnum" href="#203" name="203">0203</a>            <span class="name">value</span><span class="op">.</span><span class="name">__addtoclass__</span><span class="op">(</span><span class="name">cls</span><span class="op">,</span> <span class="name">name</span><span class="op">)</span></code></div></body></html>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-release
>
by-pkgid
>
7100f2b58690d0bf43c8eb8cfe1232ce
>
files
>
1203
