|
4 | 4 | <head>
|
5 | 5 | <meta charset="utf-8" />
|
6 | 6 | <meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
7 |
| - <title>firebird.driver.core — firebird-driver 1.6.0 documentation</title> |
| 7 | + <title>firebird.driver.core — firebird-driver 1.7.0 documentation</title> |
8 | 8 | <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css" />
|
9 | 9 | <link rel="stylesheet" type="text/css" href="../../../_static/bootstrap-sphinx.css" />
|
10 | 10 | <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
|
|
38 | 38 |
|
39 | 39 | <a class="brand" href="../../../index.html">
|
40 | 40 | firebird-driver</a>
|
41 |
| - <span class="navbar-text pull-left"><b>1.6.0</b></span> |
| 41 | + <span class="navbar-text pull-left"><b>1.7.0</b></span> |
42 | 42 |
|
43 | 43 | <div class="nav-collapse">
|
44 | 44 | <ul class="nav">
|
|
168 | 168 | </ul>
|
169 | 169 | </li>
|
170 | 170 | <li class="toctree-l1"><a class="reference internal" href="../../../changelog.html">Changelog</a><ul>
|
| 171 | +<li class="toctree-l2"><a class="reference internal" href="../../../changelog.html#version-1-7-0">Version 1.7.0</a></li> |
171 | 172 | <li class="toctree-l2"><a class="reference internal" href="../../../changelog.html#version-1-6-0">Version 1.6.0</a></li>
|
172 | 173 | <li class="toctree-l2"><a class="reference internal" href="../../../changelog.html#version-1-5-2">Version 1.5.2</a></li>
|
173 | 174 | <li class="toctree-l2"><a class="reference internal" href="../../../changelog.html#version-1-5-1">Version 1.5.1</a></li>
|
@@ -2898,13 +2899,16 @@ <h1>Source code for firebird.driver.core</h1><div class="highlight"><pre>
|
2898 | 2899 | <span class="bp">self</span><span class="o">.</span><span class="n">_out_cnt</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="n">meta</span><span class="o">.</span><span class="n">get_count</span><span class="p">()</span>
|
2899 | 2900 | <span class="bp">self</span><span class="o">.</span><span class="n">_out_buffer</span><span class="p">:</span> <span class="nb">bytes</span> <span class="o">=</span> <span class="kc">None</span>
|
2900 | 2901 | <span class="bp">self</span><span class="o">.</span><span class="n">_out_desc</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">ItemMetadata</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
|
| 2902 | + <span class="bp">self</span><span class="o">.</span><span class="n">_names</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span> |
2901 | 2903 | <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_cnt</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
|
2902 | 2904 | <span class="n">meta</span><span class="o">.</span><span class="n">release</span><span class="p">()</span>
|
2903 | 2905 | <span class="bp">self</span><span class="o">.</span><span class="n">_out_desc</span> <span class="o">=</span> <span class="p">[]</span>
|
| 2906 | + <span class="bp">self</span><span class="o">.</span><span class="n">_names</span> <span class="o">=</span> <span class="p">[]</span> |
2904 | 2907 | <span class="k">else</span><span class="p">:</span>
|
2905 | 2908 | <span class="bp">self</span><span class="o">.</span><span class="n">_out_meta</span> <span class="o">=</span> <span class="n">meta</span>
|
2906 | 2909 | <span class="bp">self</span><span class="o">.</span><span class="n">_out_buffer</span> <span class="o">=</span> <span class="n">create_string_buffer</span><span class="p">(</span><span class="n">meta</span><span class="o">.</span><span class="n">get_message_length</span><span class="p">())</span>
|
2907 | 2910 | <span class="bp">self</span><span class="o">.</span><span class="n">_out_desc</span> <span class="o">=</span> <span class="n">create_meta_descriptors</span><span class="p">(</span><span class="n">meta</span><span class="p">)</span>
|
| 2911 | + <span class="bp">self</span><span class="o">.</span><span class="n">_names</span> <span class="o">=</span> <span class="p">[</span><span class="n">meta</span><span class="o">.</span><span class="n">field</span> <span class="k">if</span> <span class="n">meta</span><span class="o">.</span><span class="n">field</span> <span class="o">==</span> <span class="n">meta</span><span class="o">.</span><span class="n">alias</span> <span class="k">else</span> <span class="n">meta</span><span class="o">.</span><span class="n">alias</span> <span class="k">for</span> <span class="n">meta</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_out_desc</span><span class="p">]</span> |
2908 | 2912 | <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">Statement</span><span class="p">:</span>
|
2909 | 2913 | <span class="k">return</span> <span class="bp">self</span>
|
2910 | 2914 | <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">traceback</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span>
|
@@ -4131,6 +4135,21 @@ <h1>Source code for firebird.driver.core</h1><div class="highlight"><pre>
|
4131 | 4135 | <span class="sd"> """</span>
|
4132 | 4136 | <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">_result</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
|
4133 | 4137 | <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_result</span><span class="o">.</span><span class="n">is_bof</span><span class="p">()</span></div>
|
| 4138 | +<div class="viewcode-block" id="Cursor.to_dict"><a class="viewcode-back" href="../../../ref-core.html#firebird.driver.core.Cursor.to_dict">[docs]</a> <span class="k">def</span> <span class="nf">to_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">row</span><span class="p">:</span> <span class="n">Tuple</span><span class="p">,</span> <span class="n">into</span><span class="p">:</span> <span class="n">Dict</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="n">Dict</span><span class="p">:</span> |
| 4139 | + <span class="sd">"""Returns row tuple as dictionary with field names as keys. Returns new dictionary</span> |
| 4140 | +<span class="sd"> if `into` argument is not provided, otherwise returns `into` dictionary updated</span> |
| 4141 | +<span class="sd"> with row data.</span> |
| 4142 | + |
| 4143 | +<span class="sd"> Arguments:</span> |
| 4144 | +<span class="sd"> row: Row data returned by fetch_* method.</span> |
| 4145 | +<span class="sd"> into: Dictionary that shouold be updated with row data.</span> |
| 4146 | +<span class="sd"> """</span> |
| 4147 | + <span class="k">assert</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_stmt</span><span class="o">.</span><span class="n">_names</span><span class="p">)</span> <span class="o">==</span> <span class="nb">len</span><span class="p">(</span><span class="n">row</span><span class="p">),</span> <span class="s2">"Length of data must match number of fields"</span> |
| 4148 | + <span class="k">if</span> <span class="n">into</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> |
| 4149 | + <span class="n">into</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_stmt</span><span class="o">.</span><span class="n">_names</span><span class="p">,</span> <span class="n">row</span><span class="p">))</span> |
| 4150 | + <span class="k">else</span><span class="p">:</span> |
| 4151 | + <span class="n">into</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_stmt</span><span class="o">.</span><span class="n">_names</span><span class="p">,</span> <span class="n">row</span><span class="p">))</span> |
| 4152 | + <span class="k">return</span> <span class="n">into</span></div> |
4134 | 4153 | <span class="c1"># Properties</span>
|
4135 | 4154 | <span class="nd">@property</span>
|
4136 | 4155 | <span class="k">def</span> <span class="nf">connection</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">Connection</span><span class="p">:</span>
|
@@ -5752,7 +5771,7 @@ <h1>Source code for firebird.driver.core</h1><div class="highlight"><pre>
|
5752 | 5771 | </p>
|
5753 | 5772 | <p>
|
5754 | 5773 | © Copyright 2020-2022, The Firebird Project.<br/>
|
5755 |
| - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 5.2.3.<br/> |
| 5774 | + Created using <a href="http://sphinx-doc.org/">Sphinx</a> 5.3.0.<br/> |
5756 | 5775 | </p>
|
5757 | 5776 | </div>
|
5758 | 5777 | </footer>
|
|
0 commit comments