anoopmb
/
frappe
1
0
Разклонения 0
Код Задачи 0 Заявки за сливане 0 Версии 0 Уики Activity
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.
252 Ревизии
1 Клон
314 MiB
 
 
 
 
 
 
ИН на ревизия: 98acabbb96
Клонове Маркери
${ item.name }
Create branch ${ searchTerm }
от '98acabbb96'
${ noResults }
frappe/docs/_build/html/_modules/webnotes/db.html

407 lines
54 KiB
Директен файл Blame История 

  1. 

  2. 

  3. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

  4.   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

  5. 

  6. <html xmlns="http://www.w3.org/1999/xhtml">

  7.   <head>

  8.     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  9.     

  10.     <title>webnotes.db &mdash; WNFramework v1.8 documentation</title>

  11.     <link rel="stylesheet" href="../../_static/default.css" type="text/css" />

  12.     <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />

  13.     <script type="text/javascript">

  14.       var DOCUMENTATION_OPTIONS = {

  15.         URL_ROOT:    '../../',

  16.         VERSION:     '1.8',

  17.         COLLAPSE_INDEX: false,

  18.         FILE_SUFFIX: '.html',

  19.         HAS_SOURCE:  true

  20.       };

  21.     </script>

  22.     <script type="text/javascript" src="../../_static/jquery.js"></script>

  23.     <script type="text/javascript" src="../../_static/underscore.js"></script>

  24.     <script type="text/javascript" src="../../_static/doctools.js"></script>

  25.     <link rel="top" title="WNFramework v1.8 documentation" href="../../index.html" />

  26.     <link rel="up" title="webnotes" href="../webnotes.html" /> 

  27.   </head>

  28.   <body>

  29.     <div class="related">

  30.       <h3>Navigation</h3>

  31.       <ul>

  32.         <li class="right" style="margin-right: 10px">

  33.           <a href="../../genindex.html" title="General Index"

  34.              accesskey="I">index</a></li>

  35.         <li class="right" >

  36.           <a href="../../py-modindex.html" title="Python Module Index"

  37.              >modules</a> |</li>

  38.         <li><a href="../../index.html">WNFramework v1.8 documentation</a> &raquo;</li>

  39.           <li><a href="../index.html" >Module code</a> &raquo;</li>

  40.           <li><a href="../webnotes.html" accesskey="U">webnotes</a> &raquo;</li> 

  41.       </ul>

  42.     </div>  

  43. 

  44.     <div class="document">

  45.       <div class="documentwrapper">

  46.         <div class="bodywrapper">

  47.           <div class="body">

  48.             

  49.   <h1>Source code for webnotes.db</h1><div class="highlight"><pre>

  50. <span class="c"># Database Module</span>

  51. <span class="c"># --------------------</span>

  52. 

  53. <span class="kn">import</span> <span class="nn">MySQLdb</span>

  54. <span class="kn">from</span> <span class="nn">webnotes</span> <span class="kn">import</span> <span class="n">defs</span>

  55. <span class="kn">import</span> <span class="nn">webnotes</span>

  56. 

  57. <div class="viewcode-block" id="Database"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database">[docs]</a><span class="k">class</span> <span class="nc">Database</span><span class="p">:</span>

  58. 	<span class="sd">&quot;&quot;&quot;</span>

  59. <span class="sd">	   Open a database connection with the given parmeters, if use_default is True, use the</span>

  60. <span class="sd">	   login details from `defs.py`. This is called by the request handler and is accessible using</span>

  61. <span class="sd">	   the `conn` global variable. the `sql` method is also global to run queries</span>

  62. <span class="sd">	&quot;&quot;&quot;</span>

  63. 	<span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="s">&#39;&#39;</span><span class="p">,</span> <span class="n">user</span><span class="o">=</span><span class="s">&#39;&#39;</span><span class="p">,</span> <span class="n">password</span><span class="o">=</span><span class="s">&#39;&#39;</span><span class="p">,</span> <span class="n">ac_name</span> <span class="o">=</span> <span class="s">&#39;&#39;</span><span class="p">,</span> <span class="n">use_default</span> <span class="o">=</span> <span class="mi">0</span><span class="p">):</span>

  64. 		<span class="bp">self</span><span class="o">.</span><span class="n">host</span> <span class="o">=</span> <span class="n">host</span> <span class="ow">or</span> <span class="s">&#39;localhost&#39;</span>

  65. 		<span class="bp">self</span><span class="o">.</span><span class="n">user</span> <span class="o">=</span> <span class="n">user</span> <span class="ow">or</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">defs</span><span class="p">,</span> <span class="s">&#39;default_db_name&#39;</span><span class="p">,</span> <span class="s">&#39;&#39;</span><span class="p">)</span>

  66. 		<span class="bp">self</span><span class="o">.</span><span class="n">password</span> <span class="o">=</span> <span class="n">password</span> <span class="ow">or</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">defs</span><span class="p">,</span> <span class="s">&#39;db_password&#39;</span><span class="p">,</span> <span class="s">&#39;&#39;</span><span class="p">)</span>

  67. 

  68. 		<span class="k">if</span> <span class="n">ac_name</span><span class="p">:</span>

  69. 			<span class="bp">self</span><span class="o">.</span><span class="n">user</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_db_login</span><span class="p">(</span><span class="n">ac_name</span><span class="p">)</span> <span class="ow">or</span> <span class="n">defs</span><span class="o">.</span><span class="n">default_db_name</span>

  70. 		

  71. 		<span class="k">if</span> <span class="n">use_default</span><span class="p">:</span>

  72. 			<span class="bp">self</span><span class="o">.</span><span class="n">user</span> <span class="o">=</span> <span class="n">defs</span><span class="o">.</span><span class="n">default_db_name</span>

  73. 

  74. 		<span class="bp">self</span><span class="o">.</span><span class="n">is_testing</span> <span class="o">=</span> <span class="mi">0</span>

  75. 		<span class="bp">self</span><span class="o">.</span><span class="n">in_transaction</span> <span class="o">=</span> <span class="mi">0</span>

  76. 		<span class="bp">self</span><span class="o">.</span><span class="n">transaction_writes</span> <span class="o">=</span> <span class="mi">0</span>

  77. 		<span class="bp">self</span><span class="o">.</span><span class="n">testing_tables</span> <span class="o">=</span> <span class="p">[]</span>

  78. 		

  79. 		<span class="bp">self</span><span class="o">.</span><span class="n">connect</span><span class="p">()</span>

  80. 		<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">user</span> <span class="o">!=</span> <span class="s">&#39;root&#39;</span><span class="p">:</span>

  81. 			<span class="bp">self</span><span class="o">.</span><span class="n">use</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">user</span><span class="p">)</span>

  82. 		

  83. 		<span class="k">if</span> <span class="n">webnotes</span><span class="o">.</span><span class="n">logger</span><span class="p">:</span>

  84. 			<span class="n">webnotes</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">&#39;Database object initialized for:</span><span class="si">%s</span><span class="s">&#39;</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">user</span><span class="p">)</span>

  85. 

  86. <div class="viewcode-block" id="Database.get_db_login"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.get_db_login">[docs]</a>	<span class="k">def</span> <span class="nf">get_db_login</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ac_name</span><span class="p">):</span>

  87. 		<span class="k">return</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">defs</span><span class="p">,</span><span class="s">&#39;db_name_map&#39;</span><span class="p">)</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">ac_name</span><span class="p">,</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">defs</span><span class="p">,</span><span class="s">&#39;default_db_name&#39;</span><span class="p">))</span>

  88. </div>

  89. <div class="viewcode-block" id="Database.connect"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.connect">[docs]</a>	<span class="k">def</span> <span class="nf">connect</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>

  90. 		<span class="sd">&quot;&quot;&quot;</span>

  91. <span class="sd">		      Connect to a database</span>

  92. <span class="sd">		&quot;&quot;&quot;</span>

  93. 		<span class="bp">self</span><span class="o">.</span><span class="n">_conn</span> <span class="o">=</span> <span class="n">MySQLdb</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="n">user</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">user</span><span class="p">,</span> <span class="n">host</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">host</span><span class="p">,</span> <span class="n">passwd</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">password</span><span class="p">)</span>

  94. 		<span class="k">try</span><span class="p">:</span>

  95. 			<span class="bp">self</span><span class="o">.</span><span class="n">_conn</span><span class="o">.</span><span class="n">set_character_set</span><span class="p">(</span><span class="s">&#39;utf8&#39;</span><span class="p">)</span>

  96. 		<span class="k">except</span><span class="p">:</span>

  97. 			<span class="k">pass</span>

  98. 

  99. 		<span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_conn</span><span class="o">.</span><span class="n">cursor</span><span class="p">()</span>

  100. 		

  101. 		<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span>

  102. 	</div>

  103. <div class="viewcode-block" id="Database.use"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.use">[docs]</a>	<span class="k">def</span> <span class="nf">use</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">db_name</span><span class="p">):</span>

  104. 		<span class="sd">&quot;&quot;&quot;</span>

  105. <span class="sd">		      `USE` db_name</span>

  106. <span class="sd">		&quot;&quot;&quot;</span>

  107. 		<span class="bp">self</span><span class="o">.</span><span class="n">_conn</span><span class="o">.</span><span class="n">select_db</span><span class="p">(</span><span class="n">db_name</span><span class="p">)</span>

  108. 		<span class="bp">self</span><span class="o">.</span><span class="n">cur_db_name</span> <span class="o">=</span> <span class="n">db_name</span>

  109. 	</div>

  110. <div class="viewcode-block" id="Database.check_transaction_status"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.check_transaction_status">[docs]</a>	<span class="k">def</span> <span class="nf">check_transaction_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query</span><span class="p">):</span>

  111. 		<span class="sd">&quot;&quot;&quot;</span>

  112. <span class="sd">		      Update *in_transaction* and check if &quot;START TRANSACTION&quot; is not called twice</span>

  113. <span class="sd">		&quot;&quot;&quot;</span>

  114. 		<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">in_transaction</span> <span class="ow">and</span> <span class="n">query</span> <span class="ow">and</span> <span class="n">query</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="p">[</span><span class="s">&#39;start&#39;</span><span class="p">,</span> <span class="s">&#39;alter&#39;</span><span class="p">,</span> <span class="s">&#39;drop&#39;</span><span class="p">,</span> <span class="s">&#39;create&#39;</span><span class="p">]:</span>

  115. 			<span class="k">raise</span> <span class="ne">Exception</span><span class="p">,</span> <span class="s">&#39;This statement can cause implicit commit&#39;</span>

  116. 

  117. 		<span class="k">if</span> <span class="n">query</span> <span class="ow">and</span> <span class="n">query</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span><span class="o">==</span><span class="s">&#39;start transaction&#39;</span><span class="p">:</span>

  118. 			<span class="bp">self</span><span class="o">.</span><span class="n">in_transaction</span> <span class="o">=</span> <span class="mi">1</span>

  119. 			<span class="bp">self</span><span class="o">.</span><span class="n">transaction_writes</span> <span class="o">=</span> <span class="mi">0</span>

  120. 			

  121. 		<span class="k">if</span> <span class="n">query</span> <span class="ow">and</span> <span class="n">query</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="p">[</span><span class="s">&#39;commit&#39;</span><span class="p">,</span> <span class="s">&#39;rollback&#39;</span><span class="p">]:</span>

  122. 			<span class="bp">self</span><span class="o">.</span><span class="n">in_transaction</span> <span class="o">=</span> <span class="mi">0</span>

  123. 

  124. 		<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">in_transaction</span> <span class="ow">and</span> <span class="n">query</span><span class="p">[:</span><span class="mi">6</span><span class="p">]</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="p">[</span><span class="s">&#39;update&#39;</span><span class="p">,</span> <span class="s">&#39;insert&#39;</span><span class="p">]:</span>

  125. 			<span class="bp">self</span><span class="o">.</span><span class="n">transaction_writes</span> <span class="o">+=</span> <span class="mi">1</span>

  126. 			<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transaction_writes</span> <span class="o">&gt;</span> <span class="mi">5000</span><span class="p">:</span>

  127. 				<span class="n">webnotes</span><span class="o">.</span><span class="n">msgprint</span><span class="p">(</span><span class="s">&#39;A very long query was encountered. If you are trying to import data, please do so using smaller files&#39;</span><span class="p">)</span>

  128. 				<span class="k">raise</span> <span class="ne">Exception</span><span class="p">,</span> <span class="s">&#39;Bad Query!!! Too many writes&#39;</span>

  129. 	</div>

  130. <div class="viewcode-block" id="Database.fetch_as_dict"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.fetch_as_dict">[docs]</a>	<span class="k">def</span> <span class="nf">fetch_as_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">formatted</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>

  131. 		<span class="sd">&quot;&quot;&quot;</span>

  132. <span class="sd">		      Internal - get results as dictionary</span>

  133. <span class="sd">		&quot;&quot;&quot;</span>

  134. 		<span class="n">result</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span><span class="o">.</span><span class="n">fetchall</span><span class="p">()</span>

  135. 		<span class="n">ret</span> <span class="o">=</span> <span class="p">[]</span>

  136. 		<span class="k">for</span> <span class="n">r</span> <span class="ow">in</span> <span class="n">result</span><span class="p">:</span>

  137. 			<span class="nb">dict</span> <span class="o">=</span> <span class="p">{}</span>

  138. 			<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">r</span><span class="p">)):</span>

  139. 				<span class="nb">dict</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span><span class="o">.</span><span class="n">description</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="mi">0</span><span class="p">]]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">convert_to_simple_type</span><span class="p">(</span><span class="n">r</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">formatted</span><span class="p">)</span>

  140. 			<span class="n">ret</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">dict</span><span class="p">)</span>

  141. 		<span class="k">return</span> <span class="n">ret</span>

  142. 	</div>

  143. <div class="viewcode-block" id="Database.validate_query"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.validate_query">[docs]</a>	<span class="k">def</span> <span class="nf">validate_query</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">q</span><span class="p">):</span>

  144. 		<span class="n">cmd</span> <span class="o">=</span> <span class="n">q</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>

  145. 		<span class="k">if</span> <span class="n">cmd</span> <span class="ow">in</span> <span class="p">[</span><span class="s">&#39;alter&#39;</span><span class="p">,</span> <span class="s">&#39;drop&#39;</span><span class="p">,</span> <span class="s">&#39;truncate&#39;</span><span class="p">]</span> <span class="ow">and</span> <span class="n">webnotes</span><span class="o">.</span><span class="n">user</span><span class="o">.</span><span class="n">name</span> <span class="o">!=</span> <span class="s">&#39;Administrator&#39;</span><span class="p">:</span>

  146. 			<span class="n">webnotes</span><span class="o">.</span><span class="n">msgprint</span><span class="p">(</span><span class="s">&#39;Not allowed to execute query&#39;</span><span class="p">)</span>

  147. 			<span class="k">raise</span> <span class="n">Execption</span>

  148. 

  149. 	<span class="c"># ======================================================================================</span>

  150. 	</div>

  151. <div class="viewcode-block" id="Database.sql"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.sql">[docs]</a>	<span class="k">def</span> <span class="nf">sql</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query</span><span class="p">,</span> <span class="n">values</span><span class="o">=</span><span class="p">(),</span> <span class="n">as_dict</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="n">as_list</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="n">formatted</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="n">ignore_no_table</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span> <span class="n">debug</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>

  152. 		<span class="sd">&quot;&quot;&quot;</span>

  153. <span class="sd">		      * Execute a `query`, with given `values`</span>

  154. <span class="sd">		      * returns as a dictionary if as_dict = 1</span>

  155. <span class="sd">		      * returns as a list of lists (with cleaned up dates and decimals) if as_list = 1</span>

  156. <span class="sd">		&quot;&quot;&quot;</span>			

  157. 		<span class="c"># in transaction validations</span>

  158. 		<span class="bp">self</span><span class="o">.</span><span class="n">check_transaction_status</span><span class="p">(</span><span class="n">query</span><span class="p">)</span>

  159. 		

  160. 		<span class="k">if</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">defs</span><span class="p">,</span><span class="s">&#39;multi_tenant&#39;</span><span class="p">,</span><span class="bp">None</span><span class="p">):</span>

  161. 			<span class="n">query</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">add_multi_tenant_condition</span><span class="p">(</span><span class="n">query</span><span class="p">)</span>

  162. 			

  163. 		<span class="c"># execute</span>

  164. 		<span class="k">if</span> <span class="n">values</span><span class="o">!=</span><span class="p">():</span>

  165. 			<span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">query</span><span class="p">,</span> <span class="n">values</span><span class="p">)</span>

  166. 			<span class="k">if</span> <span class="n">debug</span><span class="p">:</span> <span class="n">webnotes</span><span class="o">.</span><span class="n">msgprint</span><span class="p">(</span><span class="n">query</span> <span class="o">%</span> <span class="n">values</span><span class="p">)</span>

  167. 				

  168. 		<span class="k">else</span><span class="p">:</span>

  169. 			<span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">query</span><span class="p">)</span>	

  170. 			<span class="k">if</span> <span class="n">debug</span><span class="p">:</span> <span class="n">webnotes</span><span class="o">.</span><span class="n">msgprint</span><span class="p">(</span><span class="n">query</span><span class="p">)</span>

  171. 

  172. 		<span class="c"># scrub output if required</span>

  173. 		<span class="k">if</span> <span class="n">as_dict</span><span class="p">:</span>

  174. 			<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">fetch_as_dict</span><span class="p">(</span><span class="n">formatted</span><span class="p">)</span>

  175. 		<span class="k">elif</span> <span class="n">as_list</span><span class="p">:</span>

  176. 			<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">convert_to_lists</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span><span class="o">.</span><span class="n">fetchall</span><span class="p">(),</span> <span class="n">formatted</span><span class="p">)</span>

  177. 		<span class="k">else</span><span class="p">:</span>

  178. 			<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span><span class="o">.</span><span class="n">fetchall</span><span class="p">()</span>

  179. 

  180. 	<span class="c"># add condition for tenant id</span>

  181. 	<span class="c"># ======================================================================================</span></div>

  182. <div class="viewcode-block" id="Database.add_multi_tenant_condition"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.add_multi_tenant_condition">[docs]</a>	<span class="k">def</span> <span class="nf">add_multi_tenant_condition</span><span class="p">(</span><span class="n">query</span><span class="p">):</span>

  183. 		<span class="kn">import</span> <span class="nn">webnotes.multi_tenant</span>

  184. 		<span class="k">return</span> <span class="n">webnotes</span><span class="o">.</span><span class="n">multi_tenant</span><span class="o">.</span><span class="n">query_parser</span><span class="o">.</span><span class="n">add_condition</span><span class="p">(</span><span class="n">query</span><span class="p">)</span>

  185. 		

  186. 	<span class="c"># ======================================================================================</span>

  187. </div>

  188. <div class="viewcode-block" id="Database.get_description"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.get_description">[docs]</a>	<span class="k">def</span> <span class="nf">get_description</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>

  189. 		<span class="sd">&quot;&quot;&quot;</span>

  190. <span class="sd">		      Get metadata of the last query</span>

  191. <span class="sd">		&quot;&quot;&quot;</span>

  192. 		<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cursor</span><span class="o">.</span><span class="n">description</span>

  193. 

  194. 	<span class="c"># ======================================================================================</span>

  195. </div>

  196. <div class="viewcode-block" id="Database.convert_to_simple_type"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.convert_to_simple_type">[docs]</a>	<span class="k">def</span> <span class="nf">convert_to_simple_type</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">v</span><span class="p">,</span> <span class="n">formatted</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>

  197. 		<span class="k">try</span><span class="p">:</span> <span class="kn">import</span> <span class="nn">decimal</span> <span class="c"># for decimal Python 2.5 onwards</span>

  198. 		<span class="k">except</span><span class="p">:</span> <span class="k">pass</span>

  199. 		<span class="kn">import</span> <span class="nn">datetime</span>

  200. 		<span class="kn">from</span> <span class="nn">webnotes.utils</span> <span class="kn">import</span> <span class="n">formatdate</span><span class="p">,</span> <span class="n">fmt_money</span>

  201. 

  202. 		<span class="c"># date</span>

  203. 		<span class="k">if</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">==</span><span class="n">datetime</span><span class="o">.</span><span class="n">date</span><span class="p">:</span>

  204. 			<span class="n">v</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>

  205. 			<span class="k">if</span> <span class="n">formatted</span><span class="p">:</span>

  206. 				<span class="n">v</span> <span class="o">=</span> <span class="n">formatdate</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>

  207. 		

  208. 		<span class="c"># time	</span>

  209. 		<span class="k">elif</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">==</span><span class="n">datetime</span><span class="o">.</span><span class="n">timedelta</span><span class="p">:</span>

  210. 			<span class="n">h</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">v</span><span class="o">.</span><span class="n">seconds</span><span class="o">/</span><span class="mi">60</span><span class="o">/</span><span class="mi">60</span><span class="p">)</span>

  211. 			<span class="n">v</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">h</span><span class="p">)</span> <span class="o">+</span> <span class="s">&#39;:&#39;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">v</span><span class="o">.</span><span class="n">seconds</span><span class="o">/</span><span class="mi">60</span> <span class="o">-</span> <span class="n">h</span><span class="o">*</span><span class="mi">60</span><span class="p">)</span>

  212. 			<span class="k">if</span> <span class="n">v</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="o">==</span><span class="s">&#39;:&#39;</span><span class="p">:</span> 

  213. 				<span class="n">v</span><span class="o">=</span><span class="s">&#39;0&#39;</span><span class="o">+</span><span class="n">v</span>

  214. 		

  215. 		<span class="c"># datetime</span>

  216. 		<span class="k">elif</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">==</span><span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span><span class="p">:</span>

  217. 			<span class="n">v</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>

  218. 		

  219. 		<span class="c"># long</span>

  220. 		<span class="k">elif</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">==</span><span class="nb">long</span><span class="p">:</span> 

  221. 			<span class="n">v</span><span class="o">=</span><span class="nb">int</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>

  222. 

  223. 		<span class="c"># decimal</span>

  224. 		<span class="k">try</span><span class="p">:</span>

  225. 			<span class="k">if</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">==</span><span class="n">decimal</span><span class="o">.</span><span class="n">Decimal</span><span class="p">:</span> 

  226. 				<span class="n">v</span><span class="o">=</span><span class="nb">float</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>

  227. 		<span class="k">except</span><span class="p">:</span> <span class="k">pass</span>

  228. 		

  229. 		<span class="c"># convert to strings... (if formatted)</span>

  230. 		<span class="k">if</span> <span class="n">formatted</span><span class="p">:</span>

  231. 			<span class="k">if</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">==</span><span class="nb">float</span><span class="p">:</span>

  232. 				<span class="n">v</span><span class="o">=</span><span class="n">fmt_money</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>

  233. 			<span class="k">if</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">==</span><span class="nb">int</span><span class="p">:</span>

  234. 				<span class="n">v</span><span class="o">=</span><span class="nb">str</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>

  235. 		

  236. 		<span class="k">return</span> <span class="n">v</span>

  237. 

  238. 	<span class="c"># ======================================================================================</span>

  239. </div>

  240. <div class="viewcode-block" id="Database.convert_to_lists"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.convert_to_lists">[docs]</a>	<span class="k">def</span> <span class="nf">convert_to_lists</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">res</span><span class="p">,</span> <span class="n">formatted</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>

  241. 		<span class="sd">&quot;&quot;&quot;</span>

  242. <span class="sd">		      Convert the given result set to a list of lists (with cleaned up dates and decimals)</span>

  243. <span class="sd">		&quot;&quot;&quot;</span>

  244. 		<span class="n">nres</span> <span class="o">=</span> <span class="p">[]</span>

  245. 		<span class="k">for</span> <span class="n">r</span> <span class="ow">in</span> <span class="n">res</span><span class="p">:</span>

  246. 			<span class="n">nr</span> <span class="o">=</span> <span class="p">[]</span>

  247. 			<span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="n">r</span><span class="p">:</span>

  248. 				<span class="n">nr</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">convert_to_simple_type</span><span class="p">(</span><span class="n">c</span><span class="p">,</span> <span class="n">formatted</span><span class="p">))</span>

  249. 			<span class="n">nres</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">nr</span><span class="p">)</span>

  250. 		<span class="k">return</span> <span class="n">nres</span>

  251. 

  252. 	<span class="c"># ======================================================================================</span>

  253. </div>

  254. <div class="viewcode-block" id="Database.replace_tab_by_test"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.replace_tab_by_test">[docs]</a>	<span class="k">def</span> <span class="nf">replace_tab_by_test</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query</span><span class="p">):</span>

  255. 		<span class="sd">&quot;&quot;&quot;</span>

  256. <span class="sd">		      Relace all ``tab`` + doctype to ``test`` + doctype</span>

  257. <span class="sd">		&quot;&quot;&quot;</span>

  258. 		<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_testing</span><span class="p">:</span>

  259. 			<span class="n">tl</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_testing_tables</span><span class="p">()</span>

  260. 			<span class="k">for</span> <span class="n">t</span> <span class="ow">in</span> <span class="n">tl</span><span class="p">:</span>

  261. 				<span class="n">query</span> <span class="o">=</span> <span class="n">query</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">t</span><span class="p">,</span> <span class="s">&#39;test&#39;</span> <span class="o">+</span> <span class="n">t</span><span class="p">[</span><span class="mi">3</span><span class="p">:])</span>

  262. 		<span class="k">return</span> <span class="n">query</span>

  263. 		</div>

  264. <div class="viewcode-block" id="Database.get_testing_tables"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.get_testing_tables">[docs]</a>	<span class="k">def</span> <span class="nf">get_testing_tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>

  265. 		<span class="sd">&quot;&quot;&quot;</span>

  266. <span class="sd">		      Get list of all tables for which `tab` is to be replaced by `test` before a query is executed</span>

  267. <span class="sd">		&quot;&quot;&quot;</span>

  268. 		<span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">testing_tables</span><span class="p">:</span>

  269. 			<span class="n">testing_tables</span> <span class="o">=</span> <span class="p">[</span><span class="s">&#39;tab&#39;</span><span class="o">+</span><span class="n">r</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="k">for</span> <span class="n">r</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&#39;SELECT name from tabDocType where docstatus&lt;2 and (issingle=0 or issingle is null)&#39;</span><span class="p">,</span> <span class="n">allow_testing</span> <span class="o">=</span> <span class="mi">0</span><span class="p">)]</span>

  270. 			<span class="n">testing_tables</span><span class="o">+=</span><span class="p">[</span><span class="s">&#39;tabSeries&#39;</span><span class="p">,</span><span class="s">&#39;tabSingles&#39;</span><span class="p">]</span> <span class="c"># tabSessions is not included here</span>

  271. 		<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">testing_tables</span>

  272. 

  273. 	<span class="c"># ======================================================================================</span>

  274. 	<span class="c"># get a single value from a record</span>

  275. </div>

  276. <div class="viewcode-block" id="Database.get_value"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.get_value">[docs]</a>	<span class="k">def</span> <span class="nf">get_value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">doctype</span><span class="p">,</span> <span class="n">docname</span><span class="p">,</span> <span class="n">fieldname</span><span class="p">):</span>

  277. 		<span class="sd">&quot;&quot;&quot;</span>

  278. <span class="sd">		      Get a single / multiple value from a record.</span>

  279. 

  280. <span class="sd">		      For Single DocType, let docname be = None</span>

  281. <span class="sd">		&quot;&quot;&quot;</span>

  282. 			

  283. 		<span class="n">fl</span> <span class="o">=</span> <span class="n">fieldname</span>

  284. 		<span class="k">if</span> <span class="n">docname</span> <span class="ow">and</span> <span class="p">(</span><span class="n">docname</span><span class="o">!=</span><span class="n">doctype</span> <span class="ow">or</span> <span class="n">docname</span><span class="o">==</span><span class="s">&#39;DocType&#39;</span><span class="p">):</span>

  285. 			<span class="k">if</span> <span class="nb">type</span><span class="p">(</span><span class="n">fieldname</span><span class="p">)</span> <span class="ow">in</span> <span class="p">(</span><span class="nb">list</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">):</span>

  286. 				<span class="n">fl</span> <span class="o">=</span> <span class="s">&#39;`, `&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">fieldname</span><span class="p">)</span>

  287. 

  288. 			<span class="n">r</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;select `</span><span class="si">%s</span><span class="s">` from `tab</span><span class="si">%s</span><span class="s">` where name=&#39;</span><span class="si">%s</span><span class="s">&#39;&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">fl</span><span class="p">,</span> <span class="n">doctype</span><span class="p">,</span> <span class="n">docname</span><span class="p">))</span>

  289. 			<span class="k">return</span> <span class="n">r</span> <span class="ow">and</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">r</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> <span class="o">&gt;</span> <span class="mi">1</span> <span class="ow">and</span> <span class="n">r</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">or</span> <span class="n">r</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">])</span> <span class="ow">or</span> <span class="bp">None</span>

  290. 		<span class="k">else</span><span class="p">:</span>

  291. 			<span class="k">if</span> <span class="nb">type</span><span class="p">(</span><span class="n">fieldname</span><span class="p">)</span> <span class="ow">in</span> <span class="p">(</span><span class="nb">list</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">):</span>

  292. 				<span class="n">fl</span> <span class="o">=</span> <span class="s">&quot;&#39;, &#39;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">fieldname</span><span class="p">)</span>

  293. 

  294. 			<span class="n">r</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;select value from tabSingles where field in (&#39;</span><span class="si">%s</span><span class="s">&#39;) and doctype=&#39;</span><span class="si">%s</span><span class="s">&#39;&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">fieldname</span><span class="p">,</span> <span class="n">doctype</span><span class="p">))</span>

  295. 			<span class="k">return</span> <span class="n">r</span> <span class="ow">and</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">r</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span> <span class="ow">and</span> <span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">r</span><span class="p">)</span> <span class="ow">or</span> <span class="n">r</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">])</span> <span class="ow">or</span> <span class="bp">None</span>

  296. </div>

  297. <div class="viewcode-block" id="Database.set_value"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.set_value">[docs]</a>	<span class="k">def</span> <span class="nf">set_value</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">dt</span><span class="p">,</span> <span class="n">dn</span><span class="p">,</span> <span class="n">field</span><span class="p">,</span> <span class="n">val</span><span class="p">):</span>

  298. 		<span class="kn">from</span> <span class="nn">webnotes.utils</span> <span class="kn">import</span> <span class="n">now</span>

  299. 		<span class="k">if</span> <span class="n">dn</span> <span class="ow">and</span> <span class="n">dt</span><span class="o">!=</span><span class="n">dn</span><span class="p">:</span>

  300. 			<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;update `tab&quot;</span><span class="o">+</span><span class="n">dt</span><span class="o">+</span><span class="s">&quot;` set `&quot;</span><span class="o">+</span><span class="n">field</span><span class="o">+</span><span class="s">&quot;`=</span><span class="si">%s</span><span class="s">, modified=</span><span class="si">%s</span><span class="s"> where name=</span><span class="si">%s</span><span class="s">&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="n">now</span><span class="p">(),</span> <span class="n">dn</span><span class="p">))</span>

  301. 		<span class="k">else</span><span class="p">:</span>

  302. 			<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;select value from tabSingles where field=</span><span class="si">%s</span><span class="s"> and doctype=</span><span class="si">%s</span><span class="s">&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">field</span><span class="p">,</span> <span class="n">dt</span><span class="p">)):</span>

  303. 				<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;update tabSingles set value=</span><span class="si">%s</span><span class="s"> where field=</span><span class="si">%s</span><span class="s"> and doctype=</span><span class="si">%s</span><span class="s">&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="n">field</span><span class="p">,</span> <span class="n">dt</span><span class="p">))</span>

  304. 			<span class="k">else</span><span class="p">:</span>

  305. 				<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;insert into tabSingles(doctype, field, value) values (</span><span class="si">%s</span><span class="s">, </span><span class="si">%s</span><span class="s">, </span><span class="si">%s</span><span class="s">)&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">dt</span><span class="p">,</span> <span class="n">field</span><span class="p">,</span> <span class="n">val</span><span class="p">))</span>

  306. 				</div>

  307. <div class="viewcode-block" id="Database.set"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.set">[docs]</a>	<span class="k">def</span> <span class="nf">set</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">doc</span><span class="p">,</span> <span class="n">field</span><span class="p">,</span> <span class="n">val</span><span class="p">):</span>

  308. 		<span class="bp">self</span><span class="o">.</span><span class="n">set_value</span><span class="p">(</span><span class="n">doc</span><span class="o">.</span><span class="n">doctype</span><span class="p">,</span> <span class="n">doc</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">field</span><span class="p">,</span> <span class="n">val</span><span class="p">)</span>

  309. 		<span class="n">doc</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field</span><span class="p">]</span> <span class="o">=</span> <span class="n">val</span>

  310. 

  311. 	<span class="c"># ======================================================================================</span>

  312. </div>

  313. <div class="viewcode-block" id="Database.set_global"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.set_global">[docs]</a>	<span class="k">def</span> <span class="nf">set_global</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">val</span><span class="p">,</span> <span class="n">user</span><span class="o">=</span><span class="s">&#39;__global&#39;</span><span class="p">):</span>

  314. 		<span class="n">res</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&#39;select defkey from `tabDefaultValue` where defkey=</span><span class="si">%s</span><span class="s"> and parent=</span><span class="si">%s</span><span class="s">&#39;</span><span class="p">,</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">user</span><span class="p">))</span>

  315. 		<span class="k">if</span> <span class="n">res</span><span class="p">:</span>

  316. 			<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&#39;update `tabDefaultValue` set defvalue=</span><span class="si">%s</span><span class="s"> where parent=</span><span class="si">%s</span><span class="s"> and defkey=</span><span class="si">%s</span><span class="s">&#39;</span><span class="p">,</span> <span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">val</span><span class="p">),</span> <span class="n">user</span><span class="p">,</span> <span class="n">key</span><span class="p">))</span>

  317. 		<span class="k">else</span><span class="p">:</span>

  318. 			<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&#39;insert into `tabDefaultValue` (name, defkey, defvalue, parent) values (</span><span class="si">%s</span><span class="s">,</span><span class="si">%s</span><span class="s">,</span><span class="si">%s</span><span class="s">,</span><span class="si">%s</span><span class="s">)&#39;</span><span class="p">,</span> <span class="p">(</span><span class="n">user</span><span class="o">+</span><span class="s">&#39;_&#39;</span><span class="o">+</span><span class="n">key</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="n">val</span><span class="p">),</span> <span class="n">user</span><span class="p">))</span>

  319. </div>

  320. <div class="viewcode-block" id="Database.get_global"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.get_global">[docs]</a>	<span class="k">def</span> <span class="nf">get_global</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">user</span><span class="o">=</span><span class="s">&#39;__global&#39;</span><span class="p">):</span>

  321. 		<span class="n">g</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;select defvalue from tabDefaultValue where defkey=</span><span class="si">%s</span><span class="s"> and parent=</span><span class="si">%s</span><span class="s">&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">user</span><span class="p">))</span>

  322. 		<span class="k">return</span> <span class="n">g</span> <span class="ow">and</span> <span class="n">g</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="ow">or</span> <span class="bp">None</span>

  323. 

  324. 	<span class="c"># ======================================================================================</span>

  325. </div>

  326. <div class="viewcode-block" id="Database.begin"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.begin">[docs]</a>	<span class="k">def</span> <span class="nf">begin</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>

  327. 		<span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">in_transaction</span><span class="p">:</span>

  328. 			<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;start transaction&quot;</span><span class="p">)</span>

  329. 	</div>

  330. <div class="viewcode-block" id="Database.commit"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.commit">[docs]</a>	<span class="k">def</span> <span class="nf">commit</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>

  331. 		<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;commit&quot;</span><span class="p">)</span>

  332. 

  333. </div>

  334. <div class="viewcode-block" id="Database.rollback"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.rollback">[docs]</a>	<span class="k">def</span> <span class="nf">rollback</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>

  335. 		<span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;ROLLBACK&quot;</span><span class="p">)</span>

  336. 

  337. 	<span class="c"># ======================================================================================</span>

  338. </div>

  339. <div class="viewcode-block" id="Database.field_exists"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.field_exists">[docs]</a>	<span class="k">def</span> <span class="nf">field_exists</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">dt</span><span class="p">,</span> <span class="n">fn</span><span class="p">):</span>

  340. 		<span class="sd">&quot;&quot;&quot;</span>

  341. <span class="sd">		      Returns True if `fn` exists in `DocType` `dt`</span>

  342. <span class="sd">		&quot;&quot;&quot;</span>	

  343. 		<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&quot;select name from tabDocField where fieldname=</span><span class="si">%s</span><span class="s"> and parent=</span><span class="si">%s</span><span class="s">&quot;</span><span class="p">,</span> <span class="p">(</span><span class="n">dt</span><span class="p">,</span> <span class="n">fn</span><span class="p">))</span>

  344. </div>

  345. <div class="viewcode-block" id="Database.exists"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.exists">[docs]</a>	<span class="k">def</span> <span class="nf">exists</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">dt</span><span class="p">,</span> <span class="n">dn</span><span class="p">):</span>

  346. 		<span class="sd">&quot;&quot;&quot;</span>

  347. <span class="sd">		      Returns true if the record exists</span>

  348. <span class="sd">		&quot;&quot;&quot;</span>	

  349. 		<span class="k">try</span><span class="p">:</span>

  350. 			<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">sql</span><span class="p">(</span><span class="s">&#39;select name from `tab</span><span class="si">%s</span><span class="s">` where name=</span><span class="si">%s</span><span class="s">&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">dt</span><span class="p">,</span> <span class="s">&#39;</span><span class="si">%s</span><span class="s">&#39;</span><span class="p">),</span> <span class="n">dn</span><span class="p">)</span>

  351. 		<span class="k">except</span><span class="p">:</span>

  352. 			<span class="k">return</span> <span class="bp">None</span>

  353. 

  354. 	<span class="c"># ======================================================================================</span></div>

  355. <div class="viewcode-block" id="Database.close"><a class="viewcode-back" href="../../webnotes.html#webnotes.db.Database.close">[docs]</a>	<span class="k">def</span> <span class="nf">close</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>

  356. 		<span class="sd">&quot;&quot;&quot;</span>

  357. <span class="sd">		      Close my connection</span>

  358. <span class="sd">		&quot;&quot;&quot;</span>

  359. 		<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_conn</span><span class="p">:</span>

  360. 			<span class="bp">self</span><span class="o">.</span><span class="n">_conn</span><span class="o">.</span><span class="n">close</span><span class="p">()</span></div></div>

  361. </pre></div>

  362. 

  363.           </div>

  364.         </div>

  365.       </div>

  366.       <div class="sphinxsidebar">

  367.         <div class="sphinxsidebarwrapper">

  368.             <p class="logo"><a href="../../index.html">

  369.               <img class="logo" src="../../_static/wnflogo200.gif" alt="Logo"/>

  370.             </a></p>

  371. <div id="searchbox" style="display: none">

  372.   <h3>Quick search</h3>

  373.     <form class="search" action="../../search.html" method="get">

  374.       <input type="text" name="q" size="18" />

  375.       <input type="submit" value="Go" />

  376.       <input type="hidden" name="check_keywords" value="yes" />

  377.       <input type="hidden" name="area" value="default" />

  378.     </form>

  379.     <p class="searchtip" style="font-size: 90%">

  380.     Enter search terms or a module, class or function name.

  381.     </p>

  382. </div>

  383. <script type="text/javascript">$('#searchbox').show(0);</script>

  384.         </div>

  385.       </div>

  386.       <div class="clearer"></div>

  387.     </div>

  388.     <div class="related">

  389.       <h3>Navigation</h3>

  390.       <ul>

  391.         <li class="right" style="margin-right: 10px">

  392.           <a href="../../genindex.html" title="General Index"

  393.              >index</a></li>

  394.         <li class="right" >

  395.           <a href="../../py-modindex.html" title="Python Module Index"

  396.              >modules</a> |</li>

  397.         <li><a href="../../index.html">WNFramework v1.8 documentation</a> &raquo;</li>

  398.           <li><a href="../index.html" >Module code</a> &raquo;</li>

  399.           <li><a href="../webnotes.html" >webnotes</a> &raquo;</li> 

  400.       </ul>

  401.     </div>

  402.     <div class="footer">

  403.         &copy; Copyright 2011, Rushabh Mehta, Web Notes Technologies.

  404.       Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.

  405.     </div>

  406.   </body>

  407. </html>