@@ -12086,11 +12086,11 @@ <h5 id="pytkdocs.parsers.docstrings.numpy.Numpy" class="doc doc-heading">
1208612086<span class="sd"> Parse a "parameters" section.</span>
1208712087
1208812088<span class="sd"> Arguments:</span>
12089- <span class="sd"> lines : The parameters block lines .</span>
12090- <span class="sd"> start_index: The line number to start at .</span>
12089+ <span class="sd"> docstring : The raw docstring .</span>
12090+ <span class="sd"> docstring_obj: Docstring object parsed by docstring_parser .</span>
1209112091
1209212092<span class="sd"> Returns:</span>
12093- <span class="sd"> A tuple containing a `Section` (or `None`) and the index at which to continue parsing .</span>
12093+ <span class="sd"> A `Section` object (or `None` if section is empty) .</span>
1209412094<span class="sd"> """</span>
1209512095 <span class="n">parameters</span> <span class="o">=</span> <span class="p">[]</span>
1209612096
@@ -12136,10 +12136,11 @@ <h5 id="pytkdocs.parsers.docstrings.numpy.Numpy" class="doc doc-heading">
1213612136<span class="sd"> Parse an "attributes" section.</span>
1213712137
1213812138<span class="sd"> Arguments:</span>
12139+ <span class="sd"> docstring: The raw docstring.</span>
1213912140<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1214012141
1214112142<span class="sd"> Returns:</span>
12142- <span class="sd"> A tuple containing a `Section` (or `None`).</span>
12143+ <span class="sd"> A `Section` object (or `None` if section is empty ).</span>
1214312144<span class="sd"> """</span>
1214412145 <span class="n">attributes</span> <span class="o">=</span> <span class="p">[]</span>
1214512146 <span class="n">docstring_attributes</span> <span class="o">=</span> <span class="p">[</span><span class="n">p</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">params</span> <span class="k">if</span> <span class="n">p</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s2">"attribute"</span><span class="p">]</span>
@@ -12168,10 +12169,11 @@ <h5 id="pytkdocs.parsers.docstrings.numpy.Numpy" class="doc doc-heading">
1216812169<span class="sd"> Parse an "exceptions" section.</span>
1216912170
1217012171<span class="sd"> Arguments:</span>
12172+ <span class="sd"> docstring: The raw docstring.</span>
1217112173<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1217212174
1217312175<span class="sd"> Returns:</span>
12174- <span class="sd"> A tuple containing a `Section` (or `None`) and the index at which to continue parsing .</span>
12176+ <span class="sd"> A `Section` object (or `None` if section is empty) .</span>
1217512177<span class="sd"> """</span>
1217612178 <span class="n">exceptions</span> <span class="o">=</span> <span class="p">[]</span>
1217712179 <span class="n">except_obj</span> <span class="o">=</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">raises</span>
@@ -12196,7 +12198,7 @@ <h5 id="pytkdocs.parsers.docstrings.numpy.Numpy" class="doc doc-heading">
1219612198<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1219712199
1219812200<span class="sd"> Returns:</span>
12199- <span class="sd"> A tuple containing a `Section` (or `None`).</span>
12201+ <span class="sd"> A `Section` object (or `None` if section is empty ).</span>
1220012202<span class="sd"> """</span>
1220112203 <span class="n">return_obj</span> <span class="o">=</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">returns</span> <span class="k">if</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">returns</span> <span class="k">else</span> <span class="p">[]</span>
1220212204 <span class="n">text</span> <span class="o">=</span> <span class="n">return_obj</span><span class="o">.</span><span class="n">description</span> <span class="k">if</span> <span class="n">return_obj</span> <span class="k">else</span> <span class="s2">""</span>
@@ -12228,10 +12230,11 @@ <h5 id="pytkdocs.parsers.docstrings.numpy.Numpy" class="doc doc-heading">
1222812230<span class="sd"> Parse an "examples" section.</span>
1222912231
1223012232<span class="sd"> Arguments:</span>
12233+ <span class="sd"> docstring: The raw docstring.</span>
1223112234<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1223212235
1223312236<span class="sd"> Returns:</span>
12234- <span class="sd"> A tuple containing a `Section` (or `None`).</span>
12237+ <span class="sd"> A `Section` object (or `None` if section is empty ).</span>
1223512238<span class="sd"> """</span>
1223612239 <span class="n">text</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span>
1223712240 <span class="p">(</span>
@@ -12476,6 +12479,12 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_attributes_section" class="
1247612479 </tr>
1247712480 </thead>
1247812481 <tbody>
12482+ <tr>
12483+ <td><code>docstring</code></td>
12484+ <td><code>str</code></td>
12485+ <td><p>The raw docstring.</p></td>
12486+ <td><em>required</em></td>
12487+ </tr>
1247912488 <tr>
1248012489 <td><code>docstring_obj</code></td>
1248112490 <td><code>Docstring</code></td>
@@ -12495,7 +12504,7 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_attributes_section" class="
1249512504 <tbody>
1249612505 <tr>
1249712506 <td><code>Optional[pytkdocs.parsers.docstrings.base.Section]</code></td>
12498- <td><p>A tuple containing a <code>Section</code> (or <code>None</code>).</p></td>
12507+ <td><p>A <code>Section</code> object (or <code>None</code> if section is empty ).</p></td>
1249912508 </tr>
1250012509 </tbody>
1250112510</table>
@@ -12510,10 +12519,11 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_attributes_section" class="
1251012519<span class="sd"> Parse an "attributes" section.</span>
1251112520
1251212521<span class="sd"> Arguments:</span>
12522+ <span class="sd"> docstring: The raw docstring.</span>
1251312523<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1251412524
1251512525<span class="sd"> Returns:</span>
12516- <span class="sd"> A tuple containing a `Section` (or `None`).</span>
12526+ <span class="sd"> A `Section` object (or `None` if section is empty ).</span>
1251712527<span class="sd"> """</span>
1251812528 <span class="n">attributes</span> <span class="o">=</span> <span class="p">[]</span>
1251912529 <span class="n">docstring_attributes</span> <span class="o">=</span> <span class="p">[</span><span class="n">p</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">params</span> <span class="k">if</span> <span class="n">p</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s2">"attribute"</span><span class="p">]</span>
@@ -12565,6 +12575,12 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_examples_section" class="do
1256512575 </tr>
1256612576 </thead>
1256712577 <tbody>
12578+ <tr>
12579+ <td><code>docstring</code></td>
12580+ <td><code>str</code></td>
12581+ <td><p>The raw docstring.</p></td>
12582+ <td><em>required</em></td>
12583+ </tr>
1256812584 <tr>
1256912585 <td><code>docstring_obj</code></td>
1257012586 <td><code>Docstring</code></td>
@@ -12584,7 +12600,7 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_examples_section" class="do
1258412600 <tbody>
1258512601 <tr>
1258612602 <td><code>Optional[pytkdocs.parsers.docstrings.base.Section]</code></td>
12587- <td><p>A tuple containing a <code>Section</code> (or <code>None</code>).</p></td>
12603+ <td><p>A <code>Section</code> object (or <code>None</code> if section is empty ).</p></td>
1258812604 </tr>
1258912605 </tbody>
1259012606</table>
@@ -12599,10 +12615,11 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_examples_section" class="do
1259912615<span class="sd"> Parse an "examples" section.</span>
1260012616
1260112617<span class="sd"> Arguments:</span>
12618+ <span class="sd"> docstring: The raw docstring.</span>
1260212619<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1260312620
1260412621<span class="sd"> Returns:</span>
12605- <span class="sd"> A tuple containing a `Section` (or `None`).</span>
12622+ <span class="sd"> A `Section` object (or `None` if section is empty ).</span>
1260612623<span class="sd"> """</span>
1260712624 <span class="n">text</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span>
1260812625 <span class="p">(</span>
@@ -12699,6 +12716,12 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_exceptions_section" class="
1269912716 </tr>
1270012717 </thead>
1270112718 <tbody>
12719+ <tr>
12720+ <td><code>docstring</code></td>
12721+ <td><code>str</code></td>
12722+ <td><p>The raw docstring.</p></td>
12723+ <td><em>required</em></td>
12724+ </tr>
1270212725 <tr>
1270312726 <td><code>docstring_obj</code></td>
1270412727 <td><code>Docstring</code></td>
@@ -12718,7 +12741,7 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_exceptions_section" class="
1271812741 <tbody>
1271912742 <tr>
1272012743 <td><code>Optional[pytkdocs.parsers.docstrings.base.Section]</code></td>
12721- <td><p>A tuple containing a <code>Section</code> (or <code>None</code>) and the index at which to continue parsing .</p></td>
12744+ <td><p>A <code>Section</code> object (or <code>None</code> if section is empty) .</p></td>
1272212745 </tr>
1272312746 </tbody>
1272412747</table>
@@ -12733,10 +12756,11 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_exceptions_section" class="
1273312756<span class="sd"> Parse an "exceptions" section.</span>
1273412757
1273512758<span class="sd"> Arguments:</span>
12759+ <span class="sd"> docstring: The raw docstring.</span>
1273612760<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1273712761
1273812762<span class="sd"> Returns:</span>
12739- <span class="sd"> A tuple containing a `Section` (or `None`) and the index at which to continue parsing .</span>
12763+ <span class="sd"> A `Section` object (or `None` if section is empty) .</span>
1274012764<span class="sd"> """</span>
1274112765 <span class="n">exceptions</span> <span class="o">=</span> <span class="p">[]</span>
1274212766 <span class="n">except_obj</span> <span class="o">=</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">raises</span>
@@ -12783,15 +12807,15 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_parameters_section" class="
1278312807 </thead>
1278412808 <tbody>
1278512809 <tr>
12786- <td><code>lines </code></td>
12787- <td></td>
12788- <td><p>The parameters block lines .</p></td>
12810+ <td><code>docstring </code></td>
12811+ <td><code>str</code>< /td>
12812+ <td><p>The raw docstring .</p></td>
1278912813 <td><em>required</em></td>
1279012814 </tr>
1279112815 <tr>
12792- <td><code>start_index </code></td>
12793- <td></td>
12794- <td><p>The line number to start at .</p></td>
12816+ <td><code>docstring_obj </code></td>
12817+ <td><code>Docstring</code>< /td>
12818+ <td><p>Docstring object parsed by docstring_parser .</p></td>
1279512819 <td><em>required</em></td>
1279612820 </tr>
1279712821 </tbody>
@@ -12807,7 +12831,7 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_parameters_section" class="
1280712831 <tbody>
1280812832 <tr>
1280912833 <td><code>Optional[pytkdocs.parsers.docstrings.base.Section]</code></td>
12810- <td><p>A tuple containing a <code>Section</code> (or <code>None</code>) and the index at which to continue parsing .</p></td>
12834+ <td><p>A <code>Section</code> object (or <code>None</code> if section is empty) .</p></td>
1281112835 </tr>
1281212836 </tbody>
1281312837</table>
@@ -12822,11 +12846,11 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_parameters_section" class="
1282212846<span class="sd"> Parse a "parameters" section.</span>
1282312847
1282412848<span class="sd"> Arguments:</span>
12825- <span class="sd"> lines : The parameters block lines .</span>
12826- <span class="sd"> start_index: The line number to start at .</span>
12849+ <span class="sd"> docstring : The raw docstring .</span>
12850+ <span class="sd"> docstring_obj: Docstring object parsed by docstring_parser .</span>
1282712851
1282812852<span class="sd"> Returns:</span>
12829- <span class="sd"> A tuple containing a `Section` (or `None`) and the index at which to continue parsing .</span>
12853+ <span class="sd"> A `Section` object (or `None` if section is empty) .</span>
1283012854<span class="sd"> """</span>
1283112855 <span class="n">parameters</span> <span class="o">=</span> <span class="p">[]</span>
1283212856
@@ -12914,7 +12938,7 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_return_section" class="doc
1291412938 <tbody>
1291512939 <tr>
1291612940 <td><code>Optional[pytkdocs.parsers.docstrings.base.Section]</code></td>
12917- <td><p>A tuple containing a <code>Section</code> (or <code>None</code>).</p></td>
12941+ <td><p>A <code>Section</code> object (or <code>None</code> if section is empty ).</p></td>
1291812942 </tr>
1291912943 </tbody>
1292012944</table>
@@ -12931,7 +12955,7 @@ <h6 id="pytkdocs.parsers.docstrings.numpy.Numpy.read_return_section" class="doc
1293112955<span class="sd"> docstring_obj: Docstring object parsed by docstring_parser.</span>
1293212956
1293312957<span class="sd"> Returns:</span>
12934- <span class="sd"> A tuple containing a `Section` (or `None`).</span>
12958+ <span class="sd"> A `Section` object (or `None` if section is empty ).</span>
1293512959<span class="sd"> """</span>
1293612960 <span class="n">return_obj</span> <span class="o">=</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">returns</span> <span class="k">if</span> <span class="n">docstring_obj</span><span class="o">.</span><span class="n">returns</span> <span class="k">else</span> <span class="p">[]</span>
1293712961 <span class="n">text</span> <span class="o">=</span> <span class="n">return_obj</span><span class="o">.</span><span class="n">description</span> <span class="k">if</span> <span class="n">return_obj</span> <span class="k">else</span> <span class="s2">""</span>
0 commit comments