diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-14 20:18:22 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-14 20:18:22 +0000 |
| commit | 1e5c28f36b0fd2d5ac1683c88d48e3d7c243e993 (patch) | |
| tree | a81bb3938f710a181cb8cbb1ded2684711fab802 /coverage-report/d_e9c451f4ae334f76_parsing_py.html | |
| parent | Adding upstream version 0.1.27.1. (diff) | |
| download | debputy-1e5c28f36b0fd2d5ac1683c88d48e3d7c243e993.tar.xz debputy-1e5c28f36b0fd2d5ac1683c88d48e3d7c243e993.zip | |
Adding upstream version 0.1.28.upstream/0.1.28
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'coverage-report/d_e9c451f4ae334f76_parsing_py.html')
| -rw-r--r-- | coverage-report/d_e9c451f4ae334f76_parsing_py.html | 3596 |
1 files changed, 3596 insertions, 0 deletions
diff --git a/coverage-report/d_e9c451f4ae334f76_parsing_py.html b/coverage-report/d_e9c451f4ae334f76_parsing_py.html new file mode 100644 index 0000000..40a0c05 --- /dev/null +++ b/coverage-report/d_e9c451f4ae334f76_parsing_py.html @@ -0,0 +1,3596 @@ +<!DOCTYPE html> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> + <title>Coverage for src/debputy/lsp/vendoring/_deb822_repro/parsing.py: 59%</title> + <link rel="icon" sizes="32x32" href="favicon_32.png"> + <link rel="stylesheet" href="style.css" type="text/css"> + <script type="text/javascript" src="coverage_html.js" defer></script> +</head> +<body class="pyfile"> +<header> + <div class="content"> + <h1> + <span class="text">Coverage for </span><b>src/debputy/lsp/vendoring/_deb822_repro/parsing.py</b>: + <span class="pc_cov">59%</span> + </h1> + <aside id="help_panel_wrapper"> + <input id="help_panel_state" type="checkbox"> + <label for="help_panel_state"> + <img id="keyboard_icon" src="keybd_closed.png" alt="Show/hide keyboard shortcuts" /> + </label> + <div id="help_panel"> + <p class="legend">Shortcuts on this page</p> + <div class="keyhelp"> + <p> + <kbd>r</kbd> + <kbd>m</kbd> + <kbd>x</kbd> + <kbd>p</kbd> + toggle line displays + </p> + <p> + <kbd>j</kbd> + <kbd>k</kbd> + next/prev highlighted chunk + </p> + <p> + <kbd>0</kbd> (zero) top of page + </p> + <p> + <kbd>1</kbd> (one) first highlighted chunk + </p> + <p> + <kbd>[</kbd> + <kbd>]</kbd> + prev/next file + </p> + <p> + <kbd>u</kbd> up to the index + </p> + <p> + <kbd>?</kbd> show/hide this help + </p> + </div> + </div> + </aside> + <h2> + <span class="text">1464 statements </span> + <button type="button" class="run button_toggle_run" value="run" data-shortcut="r" title="Toggle lines run">923<span class="text"> run</span></button> + <button type="button" class="mis show_mis button_toggle_mis" value="mis" data-shortcut="m" title="Toggle lines missing">541<span class="text"> missing</span></button> + <button type="button" class="exc show_exc button_toggle_exc" value="exc" data-shortcut="x" title="Toggle lines excluded">30<span class="text"> excluded</span></button> + <button type="button" class="par run show_par button_toggle_par" value="par" data-shortcut="p" title="Toggle lines partially run">80<span class="text"> partial</span></button> + </h2> + <p class="text"> + <a id="prevFileLink" class="nav" href="d_e9c451f4ae334f76_locatable_py.html">« prev</a> + <a id="indexLink" class="nav" href="index.html">^ index</a> + <a id="nextFileLink" class="nav" href="d_e9c451f4ae334f76_tokens_py.html">» next</a> + + <a class="nav" href="https://coverage.readthedocs.io/en/7.2.7">coverage.py v7.2.7</a>, + created at 2024-04-07 12:14 +0200 + </p> + <aside class="hidden"> + <button type="button" class="button_next_chunk" data-shortcut="j"/> + <button type="button" class="button_prev_chunk" data-shortcut="k"/> + <button type="button" class="button_top_of_page" data-shortcut="0"/> + <button type="button" class="button_first_chunk" data-shortcut="1"/> + <button type="button" class="button_prev_file" data-shortcut="["/> + <button type="button" class="button_next_file" data-shortcut="]"/> + <button type="button" class="button_to_index" data-shortcut="u"/> + <button type="button" class="button_show_hide_help" data-shortcut="?"/> + </aside> + </div> +</header> +<main id="source"> + <p class="pln"><span class="n"><a id="t1" href="#t1">1</a></span><span class="t"><span class="com"># -*- coding: utf-8 -*- vim: fileencoding=utf-8 :</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2" href="#t2">2</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3" href="#t3">3</a></span><span class="t"><span class="key">import</span> <span class="nam">collections</span><span class="op">.</span><span class="nam">abc</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t4" href="#t4">4</a></span><span class="t"><span class="key">import</span> <span class="nam">contextlib</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t5" href="#t5">5</a></span><span class="t"><span class="key">import</span> <span class="nam">sys</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t6" href="#t6">6</a></span><span class="t"><span class="key">import</span> <span class="nam">textwrap</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t7" href="#t7">7</a></span><span class="t"><span class="key">import</span> <span class="nam">weakref</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t8" href="#t8">8</a></span><span class="t"><span class="key">from</span> <span class="nam">abc</span> <span class="key">import</span> <span class="nam">ABC</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t9" href="#t9">9</a></span><span class="t"><span class="key">from</span> <span class="nam">types</span> <span class="key">import</span> <span class="nam">TracebackType</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t10" href="#t10">10</a></span><span class="t"><span class="key">from</span> <span class="nam">weakref</span> <span class="key">import</span> <span class="nam">ReferenceType</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t11" href="#t11">11</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t12" href="#t12">12</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">_util</span> <span class="key">import</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t13" href="#t13">13</a></span><span class="t"> <span class="nam">combine_into_replacement</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t14" href="#t14">14</a></span><span class="t"> <span class="nam">BufferingIterator</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t15" href="#t15">15</a></span><span class="t"> <span class="nam">len_check_iterator</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t16" href="#t16">16</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t17" href="#t17">17</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">formatter</span> <span class="key">import</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t18" href="#t18">18</a></span><span class="t"> <span class="nam">FormatterContentToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t19" href="#t19">19</a></span><span class="t"> <span class="nam">one_value_per_line_trailing_separator</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t20" href="#t20">20</a></span><span class="t"> <span class="nam">format_field</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t21" href="#t21">21</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t22" href="#t22">22</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">locatable</span> <span class="key">import</span> <span class="nam">Locatable</span><span class="op">,</span> <span class="nam">START_POSITION</span><span class="op">,</span> <span class="nam">Position</span><span class="op">,</span> <span class="nam">Range</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t23" href="#t23">23</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">tokens</span> <span class="key">import</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t24" href="#t24">24</a></span><span class="t"> <span class="nam">Deb822Token</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t25" href="#t25">25</a></span><span class="t"> <span class="nam">Deb822ValueToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t26" href="#t26">26</a></span><span class="t"> <span class="nam">Deb822SemanticallySignificantWhiteSpace</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t27" href="#t27">27</a></span><span class="t"> <span class="nam">Deb822SpaceSeparatorToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t28" href="#t28">28</a></span><span class="t"> <span class="nam">Deb822CommentToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t29" href="#t29">29</a></span><span class="t"> <span class="nam">Deb822WhitespaceToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t30" href="#t30">30</a></span><span class="t"> <span class="nam">Deb822ValueContinuationToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t31" href="#t31">31</a></span><span class="t"> <span class="nam">Deb822NewlineAfterValueToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t32" href="#t32">32</a></span><span class="t"> <span class="nam">Deb822CommaToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t33" href="#t33">33</a></span><span class="t"> <span class="nam">Deb822FieldNameToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t34" href="#t34">34</a></span><span class="t"> <span class="nam">Deb822FieldSeparatorToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t35" href="#t35">35</a></span><span class="t"> <span class="nam">Deb822ErrorToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t36" href="#t36">36</a></span><span class="t"> <span class="nam">tokenize_deb822_file</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t37" href="#t37">37</a></span><span class="t"> <span class="nam">comma_split_tokenizer</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t38" href="#t38">38</a></span><span class="t"> <span class="nam">whitespace_split_tokenizer</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t39" href="#t39">39</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t40" href="#t40">40</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">types</span> <span class="key">import</span> <span class="nam">AmbiguousDeb822FieldKeyError</span><span class="op">,</span> <span class="nam">SyntaxOrParseError</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t41" href="#t41">41</a></span><span class="t"><span class="key">from</span> <span class="nam">debian</span><span class="op">.</span><span class="nam">_util</span> <span class="key">import</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t42" href="#t42">42</a></span><span class="t"> <span class="nam">resolve_ref</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t43" href="#t43">43</a></span><span class="t"> <span class="nam">LinkedList</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t44" href="#t44">44</a></span><span class="t"> <span class="nam">LinkedListNode</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t45" href="#t45">45</a></span><span class="t"> <span class="nam">OrderedSet</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t46" href="#t46">46</a></span><span class="t"> <span class="nam">_strI</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t47" href="#t47">47</a></span><span class="t"> <span class="nam">default_field_sort_key</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t48" href="#t48">48</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t49" href="#t49">49</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t50" href="#t50">50</a></span><span class="t"><span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t51" href="#t51">51</a></span><span class="t"> <span class="key">from</span> <span class="nam">typing</span> <span class="key">import</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t52" href="#t52">52</a></span><span class="t"> <span class="nam">Iterable</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t53" href="#t53">53</a></span><span class="t"> <span class="nam">Iterator</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t54" href="#t54">54</a></span><span class="t"> <span class="nam">List</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t55" href="#t55">55</a></span><span class="t"> <span class="nam">Union</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t56" href="#t56">56</a></span><span class="t"> <span class="nam">Dict</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t57" href="#t57">57</a></span><span class="t"> <span class="nam">Optional</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t58" href="#t58">58</a></span><span class="t"> <span class="nam">Callable</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t59" href="#t59">59</a></span><span class="t"> <span class="nam">Any</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t60" href="#t60">60</a></span><span class="t"> <span class="nam">Generic</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t61" href="#t61">61</a></span><span class="t"> <span class="nam">Type</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t62" href="#t62">62</a></span><span class="t"> <span class="nam">Tuple</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t63" href="#t63">63</a></span><span class="t"> <span class="nam">IO</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t64" href="#t64">64</a></span><span class="t"> <span class="nam">cast</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t65" href="#t65">65</a></span><span class="t"> <span class="nam">overload</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t66" href="#t66">66</a></span><span class="t"> <span class="nam">Mapping</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t67" href="#t67">67</a></span><span class="t"> <span class="nam">TYPE_CHECKING</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t68" href="#t68">68</a></span><span class="t"> <span class="nam">Sequence</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t69" href="#t69">69</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t70" href="#t70">70</a></span><span class="t"> <span class="key">from</span> <span class="nam">debian</span><span class="op">.</span><span class="nam">_util</span> <span class="key">import</span> <span class="nam">T</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t71" href="#t71">71</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t72" href="#t72">72</a></span><span class="t"> <span class="com"># for some reason, pylint does not see that Commentish is used in typing</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t73" href="#t73">73</a></span><span class="t"> <span class="key">from</span> <span class="op">.</span><span class="nam">types</span> <span class="key">import</span> <span class="op">(</span> <span class="com"># pylint: disable=unused-import</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t74" href="#t74">74</a></span><span class="t"> <span class="nam">ST</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t75" href="#t75">75</a></span><span class="t"> <span class="nam">VE</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t76" href="#t76">76</a></span><span class="t"> <span class="nam">TE</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t77" href="#t77">77</a></span><span class="t"> <span class="nam">ParagraphKey</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t78" href="#t78">78</a></span><span class="t"> <span class="nam">TokenOrElement</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t79" href="#t79">79</a></span><span class="t"> <span class="nam">Commentish</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t80" href="#t80">80</a></span><span class="t"> <span class="nam">ParagraphKeyBase</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t81" href="#t81">81</a></span><span class="t"> <span class="nam">FormatterCallback</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t82" href="#t82">82</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t83" href="#t83">83</a></span><span class="t"> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t84" href="#t84">84</a></span><span class="t"> <span class="key">if</span> <span class="nam">TYPE_CHECKING</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t85" href="#t85">85</a></span><span class="t"> <span class="nam">StreamingValueParser</span> <span class="op">=</span> <span class="nam">Callable</span><span class="op">[</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t86" href="#t86">86</a></span><span class="t"> <span class="op">[</span><span class="nam">Deb822Token</span><span class="op">,</span> <span class="nam">BufferingIterator</span><span class="op">[</span><span class="nam">Deb822Token</span><span class="op">]</span><span class="op">]</span><span class="op">,</span> <span class="nam">VE</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t87" href="#t87">87</a></span><span class="t"> <span class="op">]</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t88" href="#t88">88</a></span><span class="t"> <span class="nam">StrToValueParser</span> <span class="op">=</span> <span class="nam">Callable</span><span class="op">[</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="nam">Iterable</span><span class="op">[</span><span class="nam">Union</span><span class="op">[</span><span class="str">"Deb822Token"</span><span class="op">,</span> <span class="nam">VE</span><span class="op">]</span><span class="op">]</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t89" href="#t89">89</a></span><span class="t"> <span class="nam">KVPNode</span> <span class="op">=</span> <span class="nam">LinkedListNode</span><span class="op">[</span><span class="str">"Deb822KeyValuePairElement"</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t90" href="#t90">90</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t91" href="#t91">91</a></span><span class="t"> <span class="nam">StreamingValueParser</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t92" href="#t92">92</a></span><span class="t"> <span class="nam">StrToValueParser</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t93" href="#t93">93</a></span><span class="t"> <span class="nam">KVPNode</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t94" href="#t94">94</a></span><span class="t"><span class="key">except</span> <span class="nam">ImportError</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t95" href="#t95">95</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">TYPE_CHECKING</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t96" href="#t96">96</a></span><span class="t"> <span class="com"># pylint: disable=unnecessary-lambda-assignment</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t97" href="#t97">97</a></span><span class="t"> <span class="nam">cast</span> <span class="op">=</span> <span class="key">lambda</span> <span class="nam">t</span><span class="op">,</span> <span class="nam">v</span><span class="op">:</span> <span class="nam">v</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t98" href="#t98">98</a></span><span class="t"> <span class="nam">overload</span> <span class="op">=</span> <span class="key">lambda</span> <span class="nam">f</span><span class="op">:</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t99" href="#t99">99</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t100" href="#t100">100</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t101" href="#t101">101</a></span><span class="t"><span class="key">class</span> <span class="nam">ValueReference</span><span class="op">(</span><span class="nam">Generic</span><span class="op">[</span><span class="nam">TE</span><span class="op">]</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t102" href="#t102">102</a></span><span class="t"> <span class="str">"""Reference to a value inside a Deb822 paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t103" href="#t103">103</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t104" href="#t104">104</a></span><span class="t"><span class="str"> This is useful for cases where want to modify values "in-place" or maybe</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t105" href="#t105">105</a></span><span class="t"><span class="str"> conditionally remove a value after looking at it.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t106" href="#t106">106</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t107" href="#t107">107</a></span><span class="t"><span class="str"> ValueReferences can be invalidated by various changes or actions performed</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t108" href="#t108">108</a></span><span class="t"><span class="str"> to the underlying provider of the value reference. As an example, sorting</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t109" href="#t109">109</a></span><span class="t"><span class="str"> a list of values will generally invalidate all ValueReferences related to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t110" href="#t110">110</a></span><span class="t"><span class="str"> that list.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t111" href="#t111">111</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t112" href="#t112">112</a></span><span class="t"><span class="str"> The ValueReference will raise validity issues where it detects them but most</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t113" href="#t113">113</a></span><span class="t"><span class="str"> of the time it will not notice. As a means to this end, the ValueReference</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t114" href="#t114">114</a></span><span class="t"><span class="str"> will *not* keep a strong reference to the underlying value. This enables it</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t115" href="#t115">115</a></span><span class="t"><span class="str"> to detect when the container goes out of scope. However, keep in mind that</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t116" href="#t116">116</a></span><span class="t"><span class="str"> the timeliness of garbage collection is implementation defined (e.g., pypy</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t117" href="#t117">117</a></span><span class="t"><span class="str"> does not use ref-counting).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t118" href="#t118">118</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t119" href="#t119">119</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t120" href="#t120">120</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t121" href="#t121">121</a></span><span class="t"> <span class="str">"_node"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t122" href="#t122">122</a></span><span class="t"> <span class="str">"_render"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t123" href="#t123">123</a></span><span class="t"> <span class="str">"_value_factory"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t124" href="#t124">124</a></span><span class="t"> <span class="str">"_removal_handler"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t125" href="#t125">125</a></span><span class="t"> <span class="str">"_mutation_notifier"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t126" href="#t126">126</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t127" href="#t127">127</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t128" href="#t128">128</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t129" href="#t129">129</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t130" href="#t130">130</a></span><span class="t"> <span class="nam">node</span><span class="op">,</span> <span class="com"># type: LinkedListNode[TE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t131" href="#t131">131</a></span><span class="t"> <span class="nam">render</span><span class="op">,</span> <span class="com"># type: Callable[[TE], str]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t132" href="#t132">132</a></span><span class="t"> <span class="nam">value_factory</span><span class="op">,</span> <span class="com"># type: Callable[[str], TE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t133" href="#t133">133</a></span><span class="t"> <span class="nam">removal_handler</span><span class="op">,</span> <span class="com"># type: Callable[[LinkedListNode[TokenOrElement]], None]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t134" href="#t134">134</a></span><span class="t"> <span class="nam">mutation_notifier</span><span class="op">,</span> <span class="com"># type: Optional[Callable[[], None]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t135" href="#t135">135</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t136" href="#t136">136</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_node</span> <span class="op">=</span> <span class="nam">weakref</span><span class="op">.</span><span class="nam">ref</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t137" href="#t137">137</a></span><span class="t"> <span class="nam">node</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t138" href="#t138">138</a></span><span class="t"> <span class="op">)</span> <span class="com"># type: Optional[ReferenceType[LinkedListNode[TE]]]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t139" href="#t139">139</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_render</span> <span class="op">=</span> <span class="nam">render</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t140" href="#t140">140</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_factory</span> <span class="op">=</span> <span class="nam">value_factory</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t141" href="#t141">141</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_removal_handler</span> <span class="op">=</span> <span class="nam">removal_handler</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t142" href="#t142">142</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_mutation_notifier</span> <span class="op">=</span> <span class="nam">mutation_notifier</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t143" href="#t143">143</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t144" href="#t144">144</a></span><span class="t"> <span class="key">def</span> <span class="nam">_resolve_node</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t145" href="#t145">145</a></span><span class="t"> <span class="com"># type: () -> LinkedListNode[TE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t146" href="#t146">146</a></span><span class="t"> <span class="com"># NB: We check whether the "ref" itself is None (instead of the ref resolving to None)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t147" href="#t147">147</a></span><span class="t"> <span class="com"># This enables us to tell the difference between "known removal" vs. "garbage collected"</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t148" href="#t148">148</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">148 ↛ 149</span><span class="annotate long">line 148 didn't jump to line 149, because the condition on line 148 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t149" href="#t149">149</a></span><span class="t"> <span class="key">raise</span> <span class="nam">RuntimeError</span><span class="op">(</span><span class="str">"Cannot use ValueReference after remove()"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t150" href="#t150">150</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_node</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t151" href="#t151">151</a></span><span class="t"> <span class="key">if</span> <span class="nam">node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">151 ↛ 152</span><span class="annotate long">line 151 didn't jump to line 152, because the condition on line 151 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t152" href="#t152">152</a></span><span class="t"> <span class="key">raise</span> <span class="nam">RuntimeError</span><span class="op">(</span><span class="str">"ValueReference is invalid (garbage collected)"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t153" href="#t153">153</a></span><span class="t"> <span class="key">return</span> <span class="nam">node</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t154" href="#t154">154</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t155" href="#t155">155</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t156" href="#t156">156</a></span><span class="t"> <span class="key">def</span> <span class="nam">value</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t157" href="#t157">157</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t158" href="#t158">158</a></span><span class="t"> <span class="str">"""Resolve the reference into a str"""</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t159" href="#t159">159</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_render</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_resolve_node</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t160" href="#t160">160</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t161" href="#t161">161</a></span><span class="t"> <span class="op">@</span><span class="nam">value</span><span class="op">.</span><span class="nam">setter</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t162" href="#t162">162</a></span><span class="t"> <span class="key">def</span> <span class="nam">value</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">new_value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t163" href="#t163">163</a></span><span class="t"> <span class="com"># type: (str) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t164" href="#t164">164</a></span><span class="t"> <span class="str">"""Update the reference value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t165" href="#t165">165</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t166" href="#t166">166</a></span><span class="t"><span class="str"> Updating the value via this method will *not* invalidate the reference (or other</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t167" href="#t167">167</a></span><span class="t"><span class="str"> references to the same container).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t168" href="#t168">168</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t169" href="#t169">169</a></span><span class="t"><span class="str"> This can raise an exception if the new value does not follow the requirements</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t170" href="#t170">170</a></span><span class="t"><span class="str"> for the referenced values. As an example, values in whitespace separated</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t171" href="#t171">171</a></span><span class="t"><span class="str"> lists cannot contain spaces and would trigger an exception.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t172" href="#t172">172</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t173" href="#t173">173</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_resolve_node</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">value</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_factory</span><span class="op">(</span><span class="nam">new_value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t174" href="#t174">174</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_mutation_notifier</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t175" href="#t175">175</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_mutation_notifier</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t176" href="#t176">176</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t177" href="#t177">177</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t178" href="#t178">178</a></span><span class="t"> <span class="key">def</span> <span class="nam">locatable</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t179" href="#t179">179</a></span><span class="t"> <span class="com"># type: () -> Locatable</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t180" href="#t180">180</a></span><span class="t"> <span class="str">"""Reference to a locatable that can be used to determine where this value is"""</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t181" href="#t181">181</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_resolve_node</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t182" href="#t182">182</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t183" href="#t183">183</a></span><span class="t"> <span class="key">def</span> <span class="nam">remove</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t184" href="#t184">184</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t185" href="#t185">185</a></span><span class="t"> <span class="str">"""Remove the underlying value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t186" href="#t186">186</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t187" href="#t187">187</a></span><span class="t"><span class="str"> This will invalidate the ValueReference (and any other ValueReferences pointing</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t188" href="#t188">188</a></span><span class="t"><span class="str"> to that exact value). The validity of other ValueReferences to that container</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t189" href="#t189">189</a></span><span class="t"><span class="str"> remains unaffected.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t190" href="#t190">190</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t191" href="#t191">191</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_removal_handler</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t192" href="#t192">192</a></span><span class="t"> <span class="nam">cast</span><span class="op">(</span><span class="str">"LinkedListNode[TokenOrElement]"</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_resolve_node</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t193" href="#t193">193</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t194" href="#t194">194</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_node</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t195" href="#t195">195</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t196" href="#t196">196</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t197" href="#t197">197</a></span><span class="t"><span class="key">if</span> <span class="nam">sys</span><span class="op">.</span><span class="nam">version_info</span> <span class="op">>=</span> <span class="op">(</span><span class="num">3</span><span class="op">,</span> <span class="num">9</span><span class="op">)</span> <span class="key">or</span> <span class="nam">TYPE_CHECKING</span><span class="op">:</span> </span><span class="r"><span class="annotate short">197 ↛ 204</span><span class="annotate long">line 197 didn't jump to line 204, because the condition on line 197 was never false</span></span></p> + <p class="run"><span class="n"><a id="t198" href="#t198">198</a></span><span class="t"> <span class="nam">_Deb822ParsedTokenList_ContextManager</span> <span class="op">=</span> <span class="nam">contextlib</span><span class="op">.</span><span class="nam">AbstractContextManager</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t199" href="#t199">199</a></span><span class="t"><span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t200" href="#t200">200</a></span><span class="t"> <span class="com"># Python 3.5 - 3.8 compat - we are not allowed to subscript the abc.Iterator</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t201" href="#t201">201</a></span><span class="t"> <span class="com"># - use this little hack to work around it</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t202" href="#t202">202</a></span><span class="t"> <span class="com"># Note that Python 3.5 is so old that it does not have AbstractContextManager,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t203" href="#t203">203</a></span><span class="t"> <span class="com"># so we re-implement it here.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t204" href="#t204">204</a></span><span class="t"> <span class="key">class</span> <span class="nam">_Deb822ParsedTokenList_ContextManager</span><span class="op">(</span><span class="nam">Generic</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t205" href="#t205">205</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t206" href="#t206">206</a></span><span class="t"> <span class="key">def</span> <span class="nam">__enter__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t207" href="#t207">207</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t208" href="#t208">208</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t209" href="#t209">209</a></span><span class="t"> <span class="key">def</span> <span class="nam">__exit__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">exc_type</span><span class="op">,</span> <span class="nam">exc_val</span><span class="op">,</span> <span class="nam">exc_tb</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t210" href="#t210">210</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t211" href="#t211">211</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t212" href="#t212">212</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t213" href="#t213">213</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822ParsedTokenList</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t214" href="#t214">214</a></span><span class="t"> <span class="nam">Generic</span><span class="op">[</span><span class="nam">VE</span><span class="op">,</span> <span class="nam">ST</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t215" href="#t215">215</a></span><span class="t"> <span class="nam">_Deb822ParsedTokenList_ContextManager</span><span class="op">[</span><span class="str">"Deb822ParsedTokenList[VE, ST]"</span><span class="op">]</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t216" href="#t216">216</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t217" href="#t217">217</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t218" href="#t218">218</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t219" href="#t219">219</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t220" href="#t220">220</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">,</span> <span class="com"># type: 'Deb822KeyValuePairElement'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t221" href="#t221">221</a></span><span class="t"> <span class="nam">interpreted_value_element</span><span class="op">,</span> <span class="com"># type: Deb822InterpretationProxyElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t222" href="#t222">222</a></span><span class="t"> <span class="nam">vtype</span><span class="op">,</span> <span class="com"># type: Type[VE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t223" href="#t223">223</a></span><span class="t"> <span class="nam">stype</span><span class="op">,</span> <span class="com"># type: Type[ST]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t224" href="#t224">224</a></span><span class="t"> <span class="nam">str2value_parser</span><span class="op">,</span> <span class="com"># type: StrToValueParser[VE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t225" href="#t225">225</a></span><span class="t"> <span class="nam">default_separator_factory</span><span class="op">,</span> <span class="com"># type: Callable[[], ST]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t226" href="#t226">226</a></span><span class="t"> <span class="nam">render</span><span class="op">,</span> <span class="com"># type: Callable[[VE], str]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t227" href="#t227">227</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t228" href="#t228">228</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t229" href="#t229">229</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_element</span> <span class="op">=</span> <span class="nam">kvpair_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t230" href="#t230">230</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_proxy_element</span> <span class="op">=</span> <span class="nam">interpreted_value_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t231" href="#t231">231</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> <span class="op">=</span> <span class="nam">LinkedList</span><span class="op">(</span><span class="nam">interpreted_value_element</span><span class="op">.</span><span class="nam">parts</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t232" href="#t232">232</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> <span class="op">=</span> <span class="nam">vtype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t233" href="#t233">233</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_stype</span> <span class="op">=</span> <span class="nam">stype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t234" href="#t234">234</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_str2value_parser</span> <span class="op">=</span> <span class="nam">str2value_parser</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t235" href="#t235">235</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_default_separator_factory</span> <span class="op">=</span> <span class="nam">default_separator_factory</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t236" href="#t236">236</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_factory</span> <span class="op">=</span> <span class="nam">_parser_to_value_factory</span><span class="op">(</span><span class="nam">str2value_parser</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t237" href="#t237">237</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_render</span> <span class="op">=</span> <span class="nam">render</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t238" href="#t238">238</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_format_preserve_original_formatting</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t239" href="#t239">239</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_formatter</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t240" href="#t240">240</a></span><span class="t"> <span class="nam">one_value_per_line_trailing_separator</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t241" href="#t241">241</a></span><span class="t"> <span class="op">)</span> <span class="com"># type: FormatterCallback</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t242" href="#t242">242</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t243" href="#t243">243</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__continuation_line_char</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[str]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t244" href="#t244">244</a></span><span class="t"> <span class="key">assert</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t245" href="#t245">245</a></span><span class="t"> <span class="nam">last_token</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">tail</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t246" href="#t246">246</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t247" href="#t247">247</a></span><span class="t"> <span class="key">if</span> <span class="nam">last_token</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span> </span><span class="r"><span class="annotate short">247 ↛ exit</span><span class="annotate long">line 247 didn't return from function '__init__', because the condition on line 247 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t248" href="#t248">248</a></span><span class="t"> <span class="nam">last_token</span><span class="op">,</span> <span class="nam">Deb822NewlineAfterValueToken</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t249" href="#t249">249</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t250" href="#t250">250</a></span><span class="t"> <span class="com"># We always remove the last newline (if present), because then</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t251" href="#t251">251</a></span><span class="t"> <span class="com"># adding values will happen after the last value rather than on</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t252" href="#t252">252</a></span><span class="t"> <span class="com"># a new line by default.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t253" href="#t253">253</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t254" href="#t254">254</a></span><span class="t"> <span class="com"># On write, we always ensure the value ends on a newline (even</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t255" href="#t255">255</a></span><span class="t"> <span class="com"># if it did not before). This is simpler and should be a</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t256" href="#t256">256</a></span><span class="t"> <span class="com"># non-issue in practise.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t257" href="#t257">257</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">pop</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t258" href="#t258">258</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t259" href="#t259">259</a></span><span class="t"> <span class="key">def</span> <span class="nam">__iter__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t260" href="#t260">260</a></span><span class="t"> <span class="com"># type: () -> Iterator[str]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t261" href="#t261">261</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_render</span><span class="op">(</span><span class="nam">v</span><span class="op">)</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">value_parts</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t262" href="#t262">262</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t263" href="#t263">263</a></span><span class="t"> <span class="key">def</span> <span class="nam">__bool__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t264" href="#t264">264</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t265" href="#t265">265</a></span><span class="t"> <span class="key">return</span> <span class="nam">next</span><span class="op">(</span><span class="nam">iter</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t266" href="#t266">266</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t267" href="#t267">267</a></span><span class="t"> <span class="key">def</span> <span class="nam">__exit__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t268" href="#t268">268</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t269" href="#t269">269</a></span><span class="t"> <span class="nam">exc_type</span><span class="op">,</span> <span class="com"># type: Optional[Type[BaseException]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t270" href="#t270">270</a></span><span class="t"> <span class="nam">exc_val</span><span class="op">,</span> <span class="com"># type: Optional[BaseException]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t271" href="#t271">271</a></span><span class="t"> <span class="nam">exc_tb</span><span class="op">,</span> <span class="com"># type: Optional[TracebackType]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t272" href="#t272">272</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t273" href="#t273">273</a></span><span class="t"> <span class="com"># type: (...) -> Optional[bool]</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t274" href="#t274">274</a></span><span class="t"> <span class="key">if</span> <span class="nam">exc_type</span> <span class="key">is</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span><span class="op">:</span> </span><span class="r"><span class="annotate short">274 ↛ 276</span><span class="annotate long">line 274 didn't jump to line 276, because the condition on line 274 was never false</span></span></p> + <p class="run"><span class="n"><a id="t275" href="#t275">275</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_update_field</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t276" href="#t276">276</a></span><span class="t"> <span class="key">return</span> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__exit__</span><span class="op">(</span><span class="nam">exc_type</span><span class="op">,</span> <span class="nam">exc_val</span><span class="op">,</span> <span class="nam">exc_tb</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t277" href="#t277">277</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t278" href="#t278">278</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t279" href="#t279">279</a></span><span class="t"> <span class="key">def</span> <span class="nam">value_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t280" href="#t280">280</a></span><span class="t"> <span class="com"># type: () -> Iterator[VE]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t281" href="#t281">281</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="op">(</span><span class="nam">v</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">v</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t282" href="#t282">282</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t283" href="#t283">283</a></span><span class="t"> <span class="key">def</span> <span class="nam">_mark_changed</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t284" href="#t284">284</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t285" href="#t285">285</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t286" href="#t286">286</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t287" href="#t287">287</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_value_references</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t288" href="#t288">288</a></span><span class="t"> <span class="com"># type: () -> Iterator[ValueReference[VE]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t289" href="#t289">289</a></span><span class="t"> <span class="str">"""Iterate over all values in the list (as ValueReferences)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t290" href="#t290">290</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t291" href="#t291">291</a></span><span class="t"><span class="str"> This is useful for doing inplace modification of the values or even</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t292" href="#t292">292</a></span><span class="t"><span class="str"> streaming removal of field values. It is in general also more</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t293" href="#t293">293</a></span><span class="t"><span class="str"> efficient when more than one value is updated or removed.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t294" href="#t294">294</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t295" href="#t295">295</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t296" href="#t296">296</a></span><span class="t"> <span class="nam">ValueReference</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t297" href="#t297">297</a></span><span class="t"> <span class="nam">cast</span><span class="op">(</span><span class="str">"LinkedListNode[VE]"</span><span class="op">,</span> <span class="nam">n</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t298" href="#t298">298</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_render</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t299" href="#t299">299</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_factory</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t300" href="#t300">300</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_remove_node</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t301" href="#t301">301</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_mark_changed</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t302" href="#t302">302</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t303" href="#t303">303</a></span><span class="t"> <span class="key">for</span> <span class="nam">n</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">iter_nodes</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t304" href="#t304">304</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">n</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t305" href="#t305">305</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t306" href="#t306">306</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t307" href="#t307">307</a></span><span class="t"> <span class="key">def</span> <span class="nam">append_separator</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">space_after_separator</span><span class="op">=</span><span class="key">True</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t308" href="#t308">308</a></span><span class="t"> <span class="com"># type: (bool) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t309" href="#t309">309</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t310" href="#t310">310</a></span><span class="t"> <span class="nam">separator_token</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_default_separator_factory</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t311" href="#t311">311</a></span><span class="t"> <span class="key">if</span> <span class="nam">separator_token</span><span class="op">.</span><span class="nam">is_whitespace</span><span class="op">:</span> </span><span class="r"><span class="annotate short">311 ↛ 314</span><span class="annotate long">line 311 didn't jump to line 314, because the condition on line 311 was never false</span></span></p> + <p class="run"><span class="n"><a id="t312" href="#t312">312</a></span><span class="t"> <span class="nam">space_after_separator</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t313" href="#t313">313</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t314" href="#t314">314</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t315" href="#t315">315</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_append_continuation_line_token_if_necessary</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t316" href="#t316">316</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">separator_token</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t317" href="#t317">317</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t318" href="#t318">318</a></span><span class="t"> <span class="key">if</span> <span class="nam">space_after_separator</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">separator_token</span><span class="op">.</span><span class="nam">is_whitespace</span><span class="op">:</span> </span><span class="r"><span class="annotate short">318 ↛ 319</span><span class="annotate long">line 318 didn't jump to line 319, because the condition on line 318 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t319" href="#t319">319</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">Deb822WhitespaceToken</span><span class="op">(</span><span class="str">" "</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t320" href="#t320">320</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t321" href="#t321">321</a></span><span class="t"> <span class="key">def</span> <span class="nam">replace</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">orig_value</span><span class="op">,</span> <span class="nam">new_value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t322" href="#t322">322</a></span><span class="t"> <span class="com"># type: (str, str) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t323" href="#t323">323</a></span><span class="t"> <span class="str">"""Replace the first instance of a value with another</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t324" href="#t324">324</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t325" href="#t325">325</a></span><span class="t"><span class="str"> This method will *not* affect the validity of ValueReferences.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t326" href="#t326">326</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t327" href="#t327">327</a></span><span class="t"> <span class="nam">vtype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t328" href="#t328">328</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">iter_nodes</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">328 ↛ 334</span><span class="annotate long">line 328 didn't jump to line 334, because the loop on line 328 didn't complete</span></span></p> + <p class="run"><span class="n"><a id="t329" href="#t329">329</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span> <span class="key">and</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_render</span><span class="op">(</span><span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">)</span> <span class="op">==</span> <span class="nam">orig_value</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t330" href="#t330">330</a></span><span class="t"> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_factory</span><span class="op">(</span><span class="nam">new_value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t331" href="#t331">331</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t332" href="#t332">332</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t333" href="#t333">333</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t334" href="#t334">334</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"list.replace(x, y): x not in list"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t335" href="#t335">335</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t336" href="#t336">336</a></span><span class="t"> <span class="key">def</span> <span class="nam">remove</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t337" href="#t337">337</a></span><span class="t"> <span class="com"># type: (str) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t338" href="#t338">338</a></span><span class="t"> <span class="str">"""Remove the first instance of a value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t339" href="#t339">339</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t340" href="#t340">340</a></span><span class="t"><span class="str"> Removal will invalidate ValueReferences to the value being removed.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t341" href="#t341">341</a></span><span class="t"><span class="str"> ValueReferences to other values will be unaffected.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t342" href="#t342">342</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t343" href="#t343">343</a></span><span class="t"> <span class="nam">vtype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t344" href="#t344">344</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">iter_nodes</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t345" href="#t345">345</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span> <span class="key">and</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_render</span><span class="op">(</span><span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">)</span> <span class="op">==</span> <span class="nam">value</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t346" href="#t346">346</a></span><span class="t"> <span class="nam">node_to_remove</span> <span class="op">=</span> <span class="nam">node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t347" href="#t347">347</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t348" href="#t348">348</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t349" href="#t349">349</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"list.remove(x): x not in list"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t350" href="#t350">350</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t351" href="#t351">351</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_remove_node</span><span class="op">(</span><span class="nam">node_to_remove</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t352" href="#t352">352</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t353" href="#t353">353</a></span><span class="t"> <span class="key">def</span> <span class="nam">_remove_node</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">node_to_remove</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t354" href="#t354">354</a></span><span class="t"> <span class="com"># type: (LinkedListNode[TokenOrElement]) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t355" href="#t355">355</a></span><span class="t"> <span class="nam">vtype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t356" href="#t356">356</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t357" href="#t357">357</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t358" href="#t358">358</a></span><span class="t"> <span class="com"># We naively want to remove the node and every thing to the left of it</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t359" href="#t359">359</a></span><span class="t"> <span class="com"># until the previous value. That is the basic idea for now (ignoring</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t360" href="#t360">360</a></span><span class="t"> <span class="com"># special-cases for now).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t361" href="#t361">361</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t362" href="#t362">362</a></span><span class="t"> <span class="com"># Example:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t363" href="#t363">363</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t364" href="#t364">364</a></span><span class="t"> <span class="com"># """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t365" href="#t365">365</a></span><span class="t"> <span class="com"># Multiline-Keywords: bar[</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t366" href="#t366">366</a></span><span class="t"> <span class="com"># # Comment about foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t367" href="#t367">367</a></span><span class="t"> <span class="com"># foo]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t368" href="#t368">368</a></span><span class="t"> <span class="com"># baz</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t369" href="#t369">369</a></span><span class="t"> <span class="com"># Keywords: bar[ foo] baz</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t370" href="#t370">370</a></span><span class="t"> <span class="com"># Comma-List: bar[, foo], baz,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t371" href="#t371">371</a></span><span class="t"> <span class="com"># Multiline-Comma-List: bar[,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t372" href="#t372">372</a></span><span class="t"> <span class="com"># # Comment about foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t373" href="#t373">373</a></span><span class="t"> <span class="com"># foo],</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t374" href="#t374">374</a></span><span class="t"> <span class="com"># baz,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t375" href="#t375">375</a></span><span class="t"> <span class="com"># """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t376" href="#t376">376</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t377" href="#t377">377</a></span><span class="t"> <span class="com"># Assuming we want to remove "foo" for the lists, the []-markers</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t378" href="#t378">378</a></span><span class="t"> <span class="com"># show what we aim to remove. This has the nice side-effect of</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t379" href="#t379">379</a></span><span class="t"> <span class="com"># preserving whether nor not the value has a trailing separator.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t380" href="#t380">380</a></span><span class="t"> <span class="com"># Note that we do *not* attempt to repair missing separators but</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t381" href="#t381">381</a></span><span class="t"> <span class="com"># it may fix duplicated separators by "accident".</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t382" href="#t382">382</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t383" href="#t383">383</a></span><span class="t"> <span class="com"># Now, there are two special cases to be aware of, where this approach</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t384" href="#t384">384</a></span><span class="t"> <span class="com"># has short comings:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t385" href="#t385">385</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t386" href="#t386">386</a></span><span class="t"> <span class="com"># 1) If foo is the only value (in which case, "delete everything"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t387" href="#t387">387</a></span><span class="t"> <span class="com"># is the only option).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t388" href="#t388">388</a></span><span class="t"> <span class="com"># 2) If foo is the first value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t389" href="#t389">389</a></span><span class="t"> <span class="com"># 3) If foo is not the only value on the line and we see a comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t390" href="#t390">390</a></span><span class="t"> <span class="com"># inside the deletion range.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t391" href="#t391">391</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t392" href="#t392">392</a></span><span class="t"> <span class="com"># For 2) + 3), we attempt to flip and range to delete and every</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t393" href="#t393">393</a></span><span class="t"> <span class="com"># thing after it (up to but exclusion "baz") instead. This</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t394" href="#t394">394</a></span><span class="t"> <span class="com"># definitely fixes 3), but 2) has yet another corner case, namely:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t395" href="#t395">395</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t396" href="#t396">396</a></span><span class="t"> <span class="com"># """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t397" href="#t397">397</a></span><span class="t"> <span class="com"># Multiline-Comma-List: foo,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t398" href="#t398">398</a></span><span class="t"> <span class="com"># # Remark about bar</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t399" href="#t399">399</a></span><span class="t"> <span class="com"># bar,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t400" href="#t400">400</a></span><span class="t"> <span class="com"># Another-Case: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t401" href="#t401">401</a></span><span class="t"> <span class="com"># # Remark, also we use leading separator</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t402" href="#t402">402</a></span><span class="t"> <span class="com"># , bar</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t403" href="#t403">403</a></span><span class="t"> <span class="com"># """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t404" href="#t404">404</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t405" href="#t405">405</a></span><span class="t"> <span class="com"># The options include:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t406" href="#t406">406</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t407" href="#t407">407</a></span><span class="t"> <span class="com"># A) Discard the comment - brain-dead simple</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t408" href="#t408">408</a></span><span class="t"> <span class="com"># B) Hoist the comment up to a field comment, but then what if the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t409" href="#t409">409</a></span><span class="t"> <span class="com"># field already has a comment?</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t410" href="#t410">410</a></span><span class="t"> <span class="com"># C) Clear the first value line leaving just the newline and</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t411" href="#t411">411</a></span><span class="t"> <span class="com"># replace the separator before "bar" (if present) with a space.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t412" href="#t412">412</a></span><span class="t"> <span class="com"># (leaving you with the value of the form "\n# ...\n bar")</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t413" href="#t413">413</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t414" href="#t414">414</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t415" href="#t415">415</a></span><span class="t"> <span class="nam">first_value_on_lhs</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[LinkedListNode[TokenOrElement]]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t416" href="#t416">416</a></span><span class="t"> <span class="nam">first_value_on_rhs</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[LinkedListNode[TokenOrElement]]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t417" href="#t417">417</a></span><span class="t"> <span class="nam">comment_before_previous_value</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t418" href="#t418">418</a></span><span class="t"> <span class="nam">comment_before_next_value</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t419" href="#t419">419</a></span><span class="t"> <span class="key">for</span> <span class="nam">past_node</span> <span class="key">in</span> <span class="nam">node_to_remove</span><span class="op">.</span><span class="nam">iter_previous</span><span class="op">(</span><span class="nam">skip_current</span><span class="op">=</span><span class="key">True</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t420" href="#t420">420</a></span><span class="t"> <span class="nam">past_token</span> <span class="op">=</span> <span class="nam">past_node</span><span class="op">.</span><span class="nam">value</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t421" href="#t421">421</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">past_token</span><span class="op">,</span> <span class="nam">Deb822Token</span><span class="op">)</span> <span class="key">and</span> <span class="nam">past_token</span><span class="op">.</span><span class="nam">is_comment</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t422" href="#t422">422</a></span><span class="t"> <span class="nam">comment_before_previous_value</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t423" href="#t423">423</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t424" href="#t424">424</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">past_token</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t425" href="#t425">425</a></span><span class="t"> <span class="nam">first_value_on_lhs</span> <span class="op">=</span> <span class="nam">past_node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t426" href="#t426">426</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t427" href="#t427">427</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t428" href="#t428">428</a></span><span class="t"> <span class="key">for</span> <span class="nam">future_node</span> <span class="key">in</span> <span class="nam">node_to_remove</span><span class="op">.</span><span class="nam">iter_next</span><span class="op">(</span><span class="nam">skip_current</span><span class="op">=</span><span class="key">True</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t429" href="#t429">429</a></span><span class="t"> <span class="nam">future_token</span> <span class="op">=</span> <span class="nam">future_node</span><span class="op">.</span><span class="nam">value</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t430" href="#t430">430</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">future_token</span><span class="op">,</span> <span class="nam">Deb822Token</span><span class="op">)</span> <span class="key">and</span> <span class="nam">future_token</span><span class="op">.</span><span class="nam">is_comment</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t431" href="#t431">431</a></span><span class="t"> <span class="nam">comment_before_next_value</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t432" href="#t432">432</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t433" href="#t433">433</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">future_token</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t434" href="#t434">434</a></span><span class="t"> <span class="nam">first_value_on_rhs</span> <span class="op">=</span> <span class="nam">future_node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t435" href="#t435">435</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t436" href="#t436">436</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t437" href="#t437">437</a></span><span class="t"> <span class="key">if</span> <span class="nam">first_value_on_rhs</span> <span class="key">is</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">first_value_on_lhs</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t438" href="#t438">438</a></span><span class="t"> <span class="com"># This was the last value, just remove everything.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t439" href="#t439">439</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">clear</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t440" href="#t440">440</a></span><span class="t"> <span class="key">return</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t441" href="#t441">441</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t442" href="#t442">442</a></span><span class="t"> <span class="key">if</span> <span class="nam">first_value_on_lhs</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">comment_before_previous_value</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t443" href="#t443">443</a></span><span class="t"> <span class="com"># Delete left</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t444" href="#t444">444</a></span><span class="t"> <span class="nam">delete_lhs_of_node</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t445" href="#t445">445</a></span><span class="t"> <span class="key">elif</span> <span class="nam">first_value_on_rhs</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">comment_before_next_value</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t446" href="#t446">446</a></span><span class="t"> <span class="com"># Delete right</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t447" href="#t447">447</a></span><span class="t"> <span class="nam">delete_lhs_of_node</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t448" href="#t448">448</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t449" href="#t449">449</a></span><span class="t"> <span class="com"># There is a comment on either side (or no value on one and a</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t450" href="#t450">450</a></span><span class="t"> <span class="com"># comment and the other). Keep it simple, we just delete to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t451" href="#t451">451</a></span><span class="t"> <span class="com"># one side (preferring deleting to left if possible).</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t452" href="#t452">452</a></span><span class="t"> <span class="nam">delete_lhs_of_node</span> <span class="op">=</span> <span class="nam">first_value_on_lhs</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t453" href="#t453">453</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t454" href="#t454">454</a></span><span class="t"> <span class="key">if</span> <span class="nam">delete_lhs_of_node</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t455" href="#t455">455</a></span><span class="t"> <span class="nam">first_remain_lhs</span> <span class="op">=</span> <span class="nam">first_value_on_lhs</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t456" href="#t456">456</a></span><span class="t"> <span class="nam">first_remain_rhs</span> <span class="op">=</span> <span class="nam">node_to_remove</span><span class="op">.</span><span class="nam">next_node</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t457" href="#t457">457</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t458" href="#t458">458</a></span><span class="t"> <span class="nam">first_remain_lhs</span> <span class="op">=</span> <span class="nam">node_to_remove</span><span class="op">.</span><span class="nam">previous_node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t459" href="#t459">459</a></span><span class="t"> <span class="nam">first_remain_rhs</span> <span class="op">=</span> <span class="nam">first_value_on_rhs</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t460" href="#t460">460</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t461" href="#t461">461</a></span><span class="t"> <span class="com"># Actual deletion - with some manual labour to update HEAD/TAIL of</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t462" href="#t462">462</a></span><span class="t"> <span class="com"># the list in case we do a "delete everything left/right this node".</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t463" href="#t463">463</a></span><span class="t"> <span class="key">if</span> <span class="nam">first_remain_lhs</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t464" href="#t464">464</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">head_node</span> <span class="op">=</span> <span class="nam">first_remain_rhs</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t465" href="#t465">465</a></span><span class="t"> <span class="key">if</span> <span class="nam">first_remain_rhs</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t466" href="#t466">466</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">tail_node</span> <span class="op">=</span> <span class="nam">first_remain_lhs</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t467" href="#t467">467</a></span><span class="t"> <span class="nam">LinkedListNode</span><span class="op">.</span><span class="nam">link_nodes</span><span class="op">(</span><span class="nam">first_remain_lhs</span><span class="op">,</span> <span class="nam">first_remain_rhs</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t468" href="#t468">468</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t469" href="#t469">469</a></span><span class="t"> <span class="key">def</span> <span class="nam">append</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t470" href="#t470">470</a></span><span class="t"> <span class="com"># type: (str) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t471" href="#t471">471</a></span><span class="t"> <span class="nam">vt</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_factory</span><span class="op">(</span><span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t472" href="#t472">472</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_value</span><span class="op">(</span><span class="nam">vt</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t473" href="#t473">473</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t474" href="#t474">474</a></span><span class="t"> <span class="key">def</span> <span class="nam">append_value</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">vt</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t475" href="#t475">475</a></span><span class="t"> <span class="com"># type: (VE) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t476" href="#t476">476</a></span><span class="t"> <span class="nam">value_parts</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t477" href="#t477">477</a></span><span class="t"> <span class="key">if</span> <span class="nam">value_parts</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t478" href="#t478">478</a></span><span class="t"> <span class="nam">needs_separator</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t479" href="#t479">479</a></span><span class="t"> <span class="nam">stype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_stype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t480" href="#t480">480</a></span><span class="t"> <span class="nam">vtype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t481" href="#t481">481</a></span><span class="t"> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">reversed</span><span class="op">(</span><span class="nam">value_parts</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">481 ↛ 488</span><span class="annotate long">line 481 didn't jump to line 488, because the loop on line 481 didn't complete</span></span></p> + <p class="run"><span class="n"><a id="t482" href="#t482">482</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">t</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t483" href="#t483">483</a></span><span class="t"> <span class="nam">needs_separator</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t484" href="#t484">484</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t485" href="#t485">485</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">t</span><span class="op">,</span> <span class="nam">stype</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t486" href="#t486">486</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t487" href="#t487">487</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t488" href="#t488">488</a></span><span class="t"> <span class="key">if</span> <span class="nam">needs_separator</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t489" href="#t489">489</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_separator</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t490" href="#t490">490</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t491" href="#t491">491</a></span><span class="t"> <span class="com"># Looks nicer if there is a space before the very first value</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t492" href="#t492">492</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">Deb822WhitespaceToken</span><span class="op">(</span><span class="str">" "</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t493" href="#t493">493</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_append_continuation_line_token_if_necessary</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t494" href="#t494">494</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t495" href="#t495">495</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">vt</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t496" href="#t496">496</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t497" href="#t497">497</a></span><span class="t"> <span class="key">def</span> <span class="nam">_previous_is_newline</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t498" href="#t498">498</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t499" href="#t499">499</a></span><span class="t"> <span class="nam">tail</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">tail</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t500" href="#t500">500</a></span><span class="t"> <span class="key">return</span> <span class="nam">tail</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">tail</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t501" href="#t501">501</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t502" href="#t502">502</a></span><span class="t"> <span class="key">def</span> <span class="nam">append_newline</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t503" href="#t503">503</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t504" href="#t504">504</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_previous_is_newline</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">504 ↛ 505</span><span class="annotate long">line 504 didn't jump to line 505, because the condition on line 504 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t505" href="#t505">505</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t506" href="#t506">506</a></span><span class="t"> <span class="str">"Cannot add a newline after a token that ends on a newline"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t507" href="#t507">507</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t508" href="#t508">508</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">Deb822NewlineAfterValueToken</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t509" href="#t509">509</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t510" href="#t510">510</a></span><span class="t"> <span class="key">def</span> <span class="nam">append_comment</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">comment_text</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t511" href="#t511">511</a></span><span class="t"> <span class="com"># type: (str) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t512" href="#t512">512</a></span><span class="t"> <span class="nam">tail</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">tail</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t513" href="#t513">513</a></span><span class="t"> <span class="key">if</span> <span class="nam">tail</span> <span class="key">is</span> <span class="key">None</span> <span class="key">or</span> <span class="key">not</span> <span class="nam">tail</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t514" href="#t514">514</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_newline</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t515" href="#t515">515</a></span><span class="t"> <span class="nam">comment_token</span> <span class="op">=</span> <span class="nam">Deb822CommentToken</span><span class="op">(</span><span class="nam">_format_comment</span><span class="op">(</span><span class="nam">comment_text</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t516" href="#t516">516</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">comment_token</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t517" href="#t517">517</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t518" href="#t518">518</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t519" href="#t519">519</a></span><span class="t"> <span class="key">def</span> <span class="nam">_continuation_line_char</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t520" href="#t520">520</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t521" href="#t521">521</a></span><span class="t"> <span class="nam">char</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">__continuation_line_char</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t522" href="#t522">522</a></span><span class="t"> <span class="key">if</span> <span class="nam">char</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t523" href="#t523">523</a></span><span class="t"> <span class="com"># Use ' ' by default but match the existing field if possible.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t524" href="#t524">524</a></span><span class="t"> <span class="nam">char</span> <span class="op">=</span> <span class="str">" "</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t525" href="#t525">525</a></span><span class="t"> <span class="key">for</span> <span class="nam">token</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t526" href="#t526">526</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">Deb822ValueContinuationToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t527" href="#t527">527</a></span><span class="t"> <span class="nam">char</span> <span class="op">=</span> <span class="nam">token</span><span class="op">.</span><span class="nam">text</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t528" href="#t528">528</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t529" href="#t529">529</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__continuation_line_char</span> <span class="op">=</span> <span class="nam">char</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t530" href="#t530">530</a></span><span class="t"> <span class="key">return</span> <span class="nam">char</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t531" href="#t531">531</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t532" href="#t532">532</a></span><span class="t"> <span class="key">def</span> <span class="nam">_append_continuation_line_token_if_necessary</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t533" href="#t533">533</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t534" href="#t534">534</a></span><span class="t"> <span class="nam">tail</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">tail</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t535" href="#t535">535</a></span><span class="t"> <span class="key">if</span> <span class="nam">tail</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">tail</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">535 ↛ 536</span><span class="annotate long">line 535 didn't jump to line 536, because the condition on line 535 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t536" href="#t536">536</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t537" href="#t537">537</a></span><span class="t"> <span class="nam">Deb822ValueContinuationToken</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_continuation_line_char</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t538" href="#t538">538</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t539" href="#t539">539</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t540" href="#t540">540</a></span><span class="t"> <span class="key">def</span> <span class="nam">reformat_when_finished</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t541" href="#t541">541</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t542" href="#t542">542</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_enable_reformatting</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t543" href="#t543">543</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t544" href="#t544">544</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t545" href="#t545">545</a></span><span class="t"> <span class="key">def</span> <span class="nam">_enable_reformatting</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t546" href="#t546">546</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t547" href="#t547">547</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_format_preserve_original_formatting</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t548" href="#t548">548</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t549" href="#t549">549</a></span><span class="t"> <span class="key">def</span> <span class="nam">no_reformatting_when_finished</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t550" href="#t550">550</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t551" href="#t551">551</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_format_preserve_original_formatting</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t552" href="#t552">552</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t553" href="#t553">553</a></span><span class="t"> <span class="key">def</span> <span class="nam">value_formatter</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t554" href="#t554">554</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t555" href="#t555">555</a></span><span class="t"> <span class="nam">formatter</span><span class="op">,</span> <span class="com"># type: FormatterCallback</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t556" href="#t556">556</a></span><span class="t"> <span class="nam">force_reformat</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t557" href="#t557">557</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t558" href="#t558">558</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t559" href="#t559">559</a></span><span class="t"> <span class="str">"""Use a custom formatter when formatting the value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t560" href="#t560">560</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t561" href="#t561">561</a></span><span class="t"><span class="str"> :param formatter: A formatter (see debian._deb822_repro.formatter.format_field</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t562" href="#t562">562</a></span><span class="t"><span class="str"> for details)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t563" href="#t563">563</a></span><span class="t"><span class="str"> :param force_reformat: If True, always reformat the field even if there are</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t564" href="#t564">564</a></span><span class="t"><span class="str"> no (other) changes performed. By default, fields are only reformatted if</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t565" href="#t565">565</a></span><span class="t"><span class="str"> they are changed.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t566" href="#t566">566</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t567" href="#t567">567</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_formatter</span> <span class="op">=</span> <span class="nam">formatter</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t568" href="#t568">568</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_format_preserve_original_formatting</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t569" href="#t569">569</a></span><span class="t"> <span class="key">if</span> <span class="nam">force_reformat</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t570" href="#t570">570</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t571" href="#t571">571</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t572" href="#t572">572</a></span><span class="t"> <span class="key">def</span> <span class="nam">clear</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t573" href="#t573">573</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t574" href="#t574">574</a></span><span class="t"> <span class="str">"""Like list.clear() - removes all content (including comments and spaces)"""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t575" href="#t575">575</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t576" href="#t576">576</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t577" href="#t577">577</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">clear</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t578" href="#t578">578</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t579" href="#t579">579</a></span><span class="t"> <span class="key">def</span> <span class="nam">_iter_content_as_tokens</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t580" href="#t580">580</a></span><span class="t"> <span class="com"># type: () -> Iterable[Deb822Token]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t581" href="#t581">581</a></span><span class="t"> <span class="key">for</span> <span class="nam">te</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t582" href="#t582">582</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">te</span><span class="op">,</span> <span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t583" href="#t583">583</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">te</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t584" href="#t584">584</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t585" href="#t585">585</a></span><span class="t"> <span class="key">yield</span> <span class="nam">te</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t586" href="#t586">586</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t587" href="#t587">587</a></span><span class="t"> <span class="key">def</span> <span class="nam">_generate_reformatted_field_content</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t588" href="#t588">588</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t589" href="#t589">589</a></span><span class="t"> <span class="nam">separator_token</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_default_separator_factory</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t590" href="#t590">590</a></span><span class="t"> <span class="nam">vtype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t591" href="#t591">591</a></span><span class="t"> <span class="nam">stype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_stype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t592" href="#t592">592</a></span><span class="t"> <span class="nam">token_list</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t593" href="#t593">593</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t594" href="#t594">594</a></span><span class="t"> <span class="key">def</span> <span class="nam">_token_iter</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t595" href="#t595">595</a></span><span class="t"> <span class="com"># type: () -> Iterator[FormatterContentToken]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t596" href="#t596">596</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="str">""</span> <span class="com"># type: str</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t597" href="#t597">597</a></span><span class="t"> <span class="key">for</span> <span class="nam">te</span> <span class="key">in</span> <span class="nam">token_list</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t598" href="#t598">598</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">te</span><span class="op">,</span> <span class="nam">Deb822Token</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t599" href="#t599">599</a></span><span class="t"> <span class="key">if</span> <span class="nam">te</span><span class="op">.</span><span class="nam">is_comment</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t600" href="#t600">600</a></span><span class="t"> <span class="key">yield</span> <span class="nam">FormatterContentToken</span><span class="op">.</span><span class="nam">comment_token</span><span class="op">(</span><span class="nam">te</span><span class="op">.</span><span class="nam">text</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t601" href="#t601">601</a></span><span class="t"> <span class="key">elif</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">te</span><span class="op">,</span> <span class="nam">stype</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t602" href="#t602">602</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="nam">te</span><span class="op">.</span><span class="nam">text</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t603" href="#t603">603</a></span><span class="t"> <span class="key">yield</span> <span class="nam">FormatterContentToken</span><span class="op">.</span><span class="nam">separator_token</span><span class="op">(</span><span class="nam">text</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t604" href="#t604">604</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t605" href="#t605">605</a></span><span class="t"> <span class="key">assert</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">te</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t606" href="#t606">606</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="nam">te</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t607" href="#t607">607</a></span><span class="t"> <span class="key">yield</span> <span class="nam">FormatterContentToken</span><span class="op">.</span><span class="nam">value_token</span><span class="op">(</span><span class="nam">text</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t608" href="#t608">608</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t609" href="#t609">609</a></span><span class="t"> <span class="key">return</span> <span class="nam">format_field</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t610" href="#t610">610</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_formatter</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t611" href="#t611">611</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_element</span><span class="op">.</span><span class="nam">field_name</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t612" href="#t612">612</a></span><span class="t"> <span class="nam">FormatterContentToken</span><span class="op">.</span><span class="nam">separator_token</span><span class="op">(</span><span class="nam">separator_token</span><span class="op">.</span><span class="nam">text</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t613" href="#t613">613</a></span><span class="t"> <span class="nam">_token_iter</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t614" href="#t614">614</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t615" href="#t615">615</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t616" href="#t616">616</a></span><span class="t"> <span class="key">def</span> <span class="nam">_generate_field_content</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t617" href="#t617">617</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t618" href="#t618">618</a></span><span class="t"> <span class="key">return</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">t</span><span class="op">.</span><span class="nam">text</span> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_iter_content_as_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t619" href="#t619">619</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t620" href="#t620">620</a></span><span class="t"> <span class="key">def</span> <span class="nam">_update_field</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t621" href="#t621">621</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t622" href="#t622">622</a></span><span class="t"> <span class="nam">kvpair_element</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t623" href="#t623">623</a></span><span class="t"> <span class="nam">field_name</span> <span class="op">=</span> <span class="nam">kvpair_element</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t624" href="#t624">624</a></span><span class="t"> <span class="nam">token_list</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t625" href="#t625">625</a></span><span class="t"> <span class="nam">tail</span> <span class="op">=</span> <span class="nam">token_list</span><span class="op">.</span><span class="nam">tail</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t626" href="#t626">626</a></span><span class="t"> <span class="nam">had_tokens</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t627" href="#t627">627</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t628" href="#t628">628</a></span><span class="t"> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_iter_content_as_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">628 ↛ 633</span><span class="annotate long">line 628 didn't jump to line 633, because the loop on line 628 didn't complete</span></span></p> + <p class="run"><span class="n"><a id="t629" href="#t629">629</a></span><span class="t"> <span class="nam">had_tokens</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t630" href="#t630">630</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">t</span><span class="op">.</span><span class="nam">is_comment</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">t</span><span class="op">.</span><span class="nam">is_whitespace</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t631" href="#t631">631</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t632" href="#t632">632</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t633" href="#t633">633</a></span><span class="t"> <span class="key">if</span> <span class="nam">had_tokens</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t634" href="#t634">634</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t635" href="#t635">635</a></span><span class="t"> <span class="str">"Field must be completely empty or have content "</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t636" href="#t636">636</a></span><span class="t"> <span class="str">"(i.e. non-whitespace and non-comments)"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t637" href="#t637">637</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t638" href="#t638">638</a></span><span class="t"> <span class="key">if</span> <span class="nam">tail</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">638 ↛ 656</span><span class="annotate long">line 638 didn't jump to line 656, because the condition on line 638 was never false</span></span></p> + <p class="par run show_par"><span class="n"><a id="t639" href="#t639">639</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">tail</span><span class="op">,</span> <span class="nam">Deb822Token</span><span class="op">)</span> <span class="key">and</span> <span class="nam">tail</span><span class="op">.</span><span class="nam">is_comment</span><span class="op">:</span> </span><span class="r"><span class="annotate short">639 ↛ 640</span><span class="annotate long">line 639 didn't jump to line 640, because the condition on line 639 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t640" href="#t640">640</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Fields must not end on a comment"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t641" href="#t641">641</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">tail</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">641 ↛ 645</span><span class="annotate long">line 641 didn't jump to line 645, because the condition on line 641 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t642" href="#t642">642</a></span><span class="t"> <span class="com"># Always end on a newline</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t643" href="#t643">643</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_newline</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t644" href="#t644">644</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t645" href="#t645">645</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_format_preserve_original_formatting</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t646" href="#t646">646</a></span><span class="t"> <span class="nam">value_text</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_generate_field_content</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t647" href="#t647">647</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="str">":"</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="op">(</span><span class="nam">field_name</span><span class="op">,</span> <span class="nam">value_text</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t648" href="#t648">648</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t649" href="#t649">649</a></span><span class="t"> <span class="nam">text</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_generate_reformatted_field_content</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t650" href="#t650">650</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t651" href="#t651">651</a></span><span class="t"> <span class="nam">new_content</span> <span class="op">=</span> <span class="nam">text</span><span class="op">.</span><span class="nam">splitlines</span><span class="op">(</span><span class="nam">keepends</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t652" href="#t652">652</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t653" href="#t653">653</a></span><span class="t"> <span class="com"># Special-case for the empty list which will be mapped to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t654" href="#t654">654</a></span><span class="t"> <span class="com"># an empty field. Always end on a newline (avoids errors</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t655" href="#t655">655</a></span><span class="t"> <span class="com"># if there is a field after this)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t656" href="#t656">656</a></span><span class="t"> <span class="nam">new_content</span> <span class="op">=</span> <span class="op">[</span><span class="nam">field_name</span> <span class="op">+</span> <span class="str">":\n"</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t657" href="#t657">657</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t658" href="#t658">658</a></span><span class="t"> <span class="com"># As absurd as it might seem, it is easier to just use the parser to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t659" href="#t659">659</a></span><span class="t"> <span class="com"># construct the AST correctly</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t660" href="#t660">660</a></span><span class="t"> <span class="nam">deb822_file</span> <span class="op">=</span> <span class="nam">parse_deb822_file</span><span class="op">(</span><span class="nam">iter</span><span class="op">(</span><span class="nam">new_content</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t661" href="#t661">661</a></span><span class="t"> <span class="nam">error_token</span> <span class="op">=</span> <span class="nam">deb822_file</span><span class="op">.</span><span class="nam">find_first_error_element</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t662" href="#t662">662</a></span><span class="t"> <span class="key">if</span> <span class="nam">error_token</span><span class="op">:</span> </span><span class="r"><span class="annotate short">662 ↛ 664</span><span class="annotate long">line 662 didn't jump to line 664, because the condition on line 662 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t663" href="#t663">663</a></span><span class="t"> <span class="com"># _print_ast(deb822_file)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t664" href="#t664">664</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Syntax error in new field value for "</span> <span class="op">+</span> <span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t665" href="#t665">665</a></span><span class="t"> <span class="nam">paragraph</span> <span class="op">=</span> <span class="nam">next</span><span class="op">(</span><span class="nam">iter</span><span class="op">(</span><span class="nam">deb822_file</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t666" href="#t666">666</a></span><span class="t"> <span class="key">assert</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">paragraph</span><span class="op">,</span> <span class="nam">Deb822NoDuplicateFieldsParagraphElement</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t667" href="#t667">667</a></span><span class="t"> <span class="nam">new_kvpair_element</span> <span class="op">=</span> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t668" href="#t668">668</a></span><span class="t"> <span class="key">assert</span> <span class="nam">new_kvpair_element</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t669" href="#t669">669</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">.</span><span class="nam">value_element</span> <span class="op">=</span> <span class="nam">new_kvpair_element</span><span class="op">.</span><span class="nam">value_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t670" href="#t670">670</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t671" href="#t671">671</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t672" href="#t672">672</a></span><span class="t"> <span class="key">def</span> <span class="nam">sort_elements</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t673" href="#t673">673</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t674" href="#t674">674</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t675" href="#t675">675</a></span><span class="t"> <span class="nam">key</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> <span class="com"># type: Optional[Callable[[VE], Any]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t676" href="#t676">676</a></span><span class="t"> <span class="nam">reverse</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t677" href="#t677">677</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t678" href="#t678">678</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t679" href="#t679">679</a></span><span class="t"> <span class="str">"""Sort the elements (abstract values) in this list.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t680" href="#t680">680</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t681" href="#t681">681</a></span><span class="t"><span class="str"> This method will sort the logical values of the list. It will</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t682" href="#t682">682</a></span><span class="t"><span class="str"> attempt to preserve comments associated with a given value where</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t683" href="#t683">683</a></span><span class="t"><span class="str"> possible. Whether space and separators are preserved depends on</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t684" href="#t684">684</a></span><span class="t"><span class="str"> the contents of the field as well as the formatting settings.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t685" href="#t685">685</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t686" href="#t686">686</a></span><span class="t"><span class="str"> Sorting (without reformatting) is likely to leave you with "awkward"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t687" href="#t687">687</a></span><span class="t"><span class="str"> whitespace. Therefore, you almost always want to apply reformatting</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t688" href="#t688">688</a></span><span class="t"><span class="str"> such as the reformat_when_finished() method.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t689" href="#t689">689</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t690" href="#t690">690</a></span><span class="t"><span class="str"> Sorting will invalidate all ValueReferences.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t691" href="#t691">691</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t692" href="#t692">692</a></span><span class="t"> <span class="nam">comment_start_node</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t693" href="#t693">693</a></span><span class="t"> <span class="nam">vtype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t694" href="#t694">694</a></span><span class="t"> <span class="nam">stype</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_stype</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t695" href="#t695">695</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t696" href="#t696">696</a></span><span class="t"> <span class="key">def</span> <span class="nam">key_func</span><span class="op">(</span><span class="nam">x</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t697" href="#t697">697</a></span><span class="t"> <span class="com"># type: (Tuple[VE, List[TokenOrElement]]) -> Any</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t698" href="#t698">698</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span><span class="op">:</span> </span><span class="r"><span class="annotate short">698 ↛ 699</span><span class="annotate long">line 698 didn't jump to line 699, because the condition on line 698 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t699" href="#t699">699</a></span><span class="t"> <span class="key">return</span> <span class="nam">key</span><span class="op">(</span><span class="nam">x</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t700" href="#t700">700</a></span><span class="t"> <span class="key">return</span> <span class="nam">x</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t701" href="#t701">701</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t702" href="#t702">702</a></span><span class="t"> <span class="nam">parts</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t703" href="#t703">703</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t704" href="#t704">704</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">iter_nodes</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t705" href="#t705">705</a></span><span class="t"> <span class="nam">value</span> <span class="op">=</span> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t706" href="#t706">706</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">value</span><span class="op">,</span> <span class="nam">Deb822Token</span><span class="op">)</span> <span class="key">and</span> <span class="nam">value</span><span class="op">.</span><span class="nam">is_comment</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t707" href="#t707">707</a></span><span class="t"> <span class="key">if</span> <span class="nam">comment_start_node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">707 ↛ 709</span><span class="annotate long">line 707 didn't jump to line 709, because the condition on line 707 was never false</span></span></p> + <p class="run"><span class="n"><a id="t708" href="#t708">708</a></span><span class="t"> <span class="nam">comment_start_node</span> <span class="op">=</span> <span class="nam">node</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t709" href="#t709">709</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t710" href="#t710">710</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t711" href="#t711">711</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">value</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t712" href="#t712">712</a></span><span class="t"> <span class="nam">comments</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t713" href="#t713">713</a></span><span class="t"> <span class="key">if</span> <span class="nam">comment_start_node</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t714" href="#t714">714</a></span><span class="t"> <span class="key">for</span> <span class="nam">keep_node</span> <span class="key">in</span> <span class="nam">comment_start_node</span><span class="op">.</span><span class="nam">iter_next</span><span class="op">(</span><span class="nam">skip_current</span><span class="op">=</span><span class="key">False</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">714 ↛ 718</span><span class="annotate long">line 714 didn't jump to line 718, because the loop on line 714 didn't complete</span></span></p> + <p class="run"><span class="n"><a id="t715" href="#t715">715</a></span><span class="t"> <span class="key">if</span> <span class="nam">keep_node</span> <span class="key">is</span> <span class="nam">node</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t716" href="#t716">716</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t717" href="#t717">717</a></span><span class="t"> <span class="nam">comments</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">keep_node</span><span class="op">.</span><span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t718" href="#t718">718</a></span><span class="t"> <span class="nam">parts</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="op">(</span><span class="nam">value</span><span class="op">,</span> <span class="nam">comments</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t719" href="#t719">719</a></span><span class="t"> <span class="nam">comment_start_node</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t720" href="#t720">720</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t721" href="#t721">721</a></span><span class="t"> <span class="nam">parts</span><span class="op">.</span><span class="nam">sort</span><span class="op">(</span><span class="nam">key</span><span class="op">=</span><span class="nam">key_func</span><span class="op">,</span> <span class="nam">reverse</span><span class="op">=</span><span class="nam">reverse</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t722" href="#t722">722</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t723" href="#t723">723</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_changed</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t724" href="#t724">724</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">clear</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t725" href="#t725">725</a></span><span class="t"> <span class="nam">first_value</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t726" href="#t726">726</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t727" href="#t727">727</a></span><span class="t"> <span class="nam">separator_is_space</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_default_separator_factory</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">is_whitespace</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t728" href="#t728">728</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t729" href="#t729">729</a></span><span class="t"> <span class="key">for</span> <span class="nam">value</span><span class="op">,</span> <span class="nam">comments</span> <span class="key">in</span> <span class="nam">parts</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t730" href="#t730">730</a></span><span class="t"> <span class="key">if</span> <span class="nam">first_value</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t731" href="#t731">731</a></span><span class="t"> <span class="nam">first_value</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t732" href="#t732">732</a></span><span class="t"> <span class="key">if</span> <span class="nam">comments</span><span class="op">:</span> </span><span class="r"><span class="annotate short">732 ↛ 735</span><span class="annotate long">line 732 didn't jump to line 735, because the condition on line 732 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t733" href="#t733">733</a></span><span class="t"> <span class="com"># While unlikely, there could be a separator between the comments.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t734" href="#t734">734</a></span><span class="t"> <span class="com"># It would be in the way and we remove it.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t735" href="#t735">735</a></span><span class="t"> <span class="nam">comments</span> <span class="op">=</span> <span class="op">[</span><span class="nam">x</span> <span class="key">for</span> <span class="nam">x</span> <span class="key">in</span> <span class="nam">comments</span> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">x</span><span class="op">,</span> <span class="nam">stype</span><span class="op">)</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t736" href="#t736">736</a></span><span class="t"> <span class="com"># Comments cannot start the field, so inject a newline to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t737" href="#t737">737</a></span><span class="t"> <span class="com"># work around that</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t738" href="#t738">738</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_newline</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t739" href="#t739">739</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t740" href="#t740">740</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">separator_is_space</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">any</span><span class="op">(</span> </span><span class="r"><span class="annotate short">740 ↛ exit, 740 ↛ 747</span><span class="annotate long">2 missed branches: 1) line 740 didn't run the generator expression on line 740, 2) line 740 didn't jump to line 747, because the condition on line 740 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t741" href="#t741">741</a></span><span class="t"> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">x</span><span class="op">,</span> <span class="nam">stype</span><span class="op">)</span> <span class="key">for</span> <span class="nam">x</span> <span class="key">in</span> <span class="nam">comments</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t742" href="#t742">742</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t743" href="#t743">743</a></span><span class="t"> <span class="com"># While unlikely, you can hide a comma between two comments and expect</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t744" href="#t744">744</a></span><span class="t"> <span class="com"># us to preserve it. However, the more common case is that the separator</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t745" href="#t745">745</a></span><span class="t"> <span class="com"># appeared before the comments and was thus omitted (leaving us to re-add</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t746" href="#t746">746</a></span><span class="t"> <span class="com"># it here).</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t747" href="#t747">747</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_separator</span><span class="op">(</span><span class="nam">space_after_separator</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t748" href="#t748">748</a></span><span class="t"> <span class="key">if</span> <span class="nam">comments</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t749" href="#t749">749</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_newline</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t750" href="#t750">750</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t751" href="#t751">751</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">Deb822WhitespaceToken</span><span class="op">(</span><span class="str">" "</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t752" href="#t752">752</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t753" href="#t753">753</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">comments</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t754" href="#t754">754</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append_value</span><span class="op">(</span><span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t755" href="#t755">755</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t756" href="#t756">756</a></span><span class="t"> <span class="key">def</span> <span class="nam">sort</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t757" href="#t757">757</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t758" href="#t758">758</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t759" href="#t759">759</a></span><span class="t"> <span class="nam">key</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> <span class="com"># type: Optional[Callable[[str], Any]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t760" href="#t760">760</a></span><span class="t"> <span class="op">**</span><span class="nam">kwargs</span><span class="op">,</span> <span class="com"># type: Any</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t761" href="#t761">761</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t762" href="#t762">762</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t763" href="#t763">763</a></span><span class="t"> <span class="str">"""Sort the values (rendered as str) in this list.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t764" href="#t764">764</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t765" href="#t765">765</a></span><span class="t"><span class="str"> This method will sort the logical values of the list. It will</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t766" href="#t766">766</a></span><span class="t"><span class="str"> attempt to preserve comments associated with a given value where</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t767" href="#t767">767</a></span><span class="t"><span class="str"> possible. Whether space and separators are preserved depends on</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t768" href="#t768">768</a></span><span class="t"><span class="str"> the contents of the field as well as the formatting settings.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t769" href="#t769">769</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t770" href="#t770">770</a></span><span class="t"><span class="str"> Sorting (without reformatting) is likely to leave you with "awkward"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t771" href="#t771">771</a></span><span class="t"><span class="str"> whitespace. Therefore, you almost always want to apply reformatting</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t772" href="#t772">772</a></span><span class="t"><span class="str"> such as the reformat_when_finished() method.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t773" href="#t773">773</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t774" href="#t774">774</a></span><span class="t"><span class="str"> Sorting will invalidate all ValueReferences.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t775" href="#t775">775</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t776" href="#t776">776</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">776 ↛ 777</span><span class="annotate long">line 776 didn't jump to line 777, because the condition on line 776 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t777" href="#t777">777</a></span><span class="t"> <span class="nam">render</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_render</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t778" href="#t778">778</a></span><span class="t"> <span class="nam">kwargs</span><span class="op">[</span><span class="str">"key"</span><span class="op">]</span> <span class="op">=</span> <span class="key">lambda</span> <span class="nam">vt</span><span class="op">:</span> <span class="nam">key</span><span class="op">(</span><span class="nam">render</span><span class="op">(</span><span class="nam">vt</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t779" href="#t779">779</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">sort_elements</span><span class="op">(</span><span class="op">**</span><span class="nam">kwargs</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t780" href="#t780">780</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t781" href="#t781">781</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t782" href="#t782">782</a></span><span class="t"><span class="key">class</span> <span class="nam">Interpretation</span><span class="op">(</span><span class="nam">Generic</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t783" href="#t783">783</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t784" href="#t784">784</a></span><span class="t"> <span class="key">def</span> <span class="nam">interpret</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t785" href="#t785">785</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t786" href="#t786">786</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">,</span> <span class="com"># type: Deb822KeyValuePairElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t787" href="#t787">787</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t788" href="#t788">788</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t789" href="#t789">789</a></span><span class="t"> <span class="com"># type: (...) -> T</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t790" href="#t790">790</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t791" href="#t791">791</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t792" href="#t792">792</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t793" href="#t793">793</a></span><span class="t"><span class="key">class</span> <span class="nam">GenericContentBasedInterpretation</span><span class="op">(</span><span class="nam">Interpretation</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">,</span> <span class="nam">Generic</span><span class="op">[</span><span class="nam">T</span><span class="op">,</span> <span class="nam">VE</span><span class="op">]</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t794" href="#t794">794</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t795" href="#t795">795</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t796" href="#t796">796</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t797" href="#t797">797</a></span><span class="t"> <span class="nam">tokenizer</span><span class="op">,</span> <span class="com"># type: Callable[[str], Iterable['Deb822Token']]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t798" href="#t798">798</a></span><span class="t"> <span class="nam">value_parser</span><span class="op">,</span> <span class="com"># type: StreamingValueParser[VE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t799" href="#t799">799</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t800" href="#t800">800</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t801" href="#t801">801</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t802" href="#t802">802</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_tokenizer</span> <span class="op">=</span> <span class="nam">tokenizer</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t803" href="#t803">803</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_parser</span> <span class="op">=</span> <span class="nam">value_parser</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t804" href="#t804">804</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t805" href="#t805">805</a></span><span class="t"> <span class="key">def</span> <span class="nam">_high_level_interpretation</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t806" href="#t806">806</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t807" href="#t807">807</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">,</span> <span class="com"># type: Deb822KeyValuePairElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t808" href="#t808">808</a></span><span class="t"> <span class="nam">proxy_element</span><span class="op">,</span> <span class="com"># type: Deb822InterpretationProxyElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t809" href="#t809">809</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t810" href="#t810">810</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t811" href="#t811">811</a></span><span class="t"> <span class="com"># type: (...) -> T</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t812" href="#t812">812</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t813" href="#t813">813</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t814" href="#t814">814</a></span><span class="t"> <span class="key">def</span> <span class="nam">_parse_stream</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t815" href="#t815">815</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">buffered_iterator</span> <span class="com"># type: BufferingIterator[Deb822Token]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t816" href="#t816">816</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t817" href="#t817">817</a></span><span class="t"> <span class="com"># type: (...) -> Iterable[Union[Deb822Token, VE]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t818" href="#t818">818</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t819" href="#t819">819</a></span><span class="t"> <span class="nam">value_parser</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_parser</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t820" href="#t820">820</a></span><span class="t"> <span class="key">for</span> <span class="nam">token</span> <span class="key">in</span> <span class="nam">buffered_iterator</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t821" href="#t821">821</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">Deb822ValueToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t822" href="#t822">822</a></span><span class="t"> <span class="key">yield</span> <span class="nam">value_parser</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">buffered_iterator</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t823" href="#t823">823</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t824" href="#t824">824</a></span><span class="t"> <span class="key">yield</span> <span class="nam">token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t825" href="#t825">825</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t826" href="#t826">826</a></span><span class="t"> <span class="key">def</span> <span class="nam">_parse_kvpair</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t827" href="#t827">827</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">kvpair</span> <span class="com"># type: Deb822KeyValuePairElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t828" href="#t828">828</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t829" href="#t829">829</a></span><span class="t"> <span class="com"># type: (...) -> Deb822InterpretationProxyElement</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t830" href="#t830">830</a></span><span class="t"> <span class="nam">value_element</span> <span class="op">=</span> <span class="nam">kvpair</span><span class="op">.</span><span class="nam">value_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t831" href="#t831">831</a></span><span class="t"> <span class="nam">content</span> <span class="op">=</span> <span class="nam">value_element</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t832" href="#t832">832</a></span><span class="t"> <span class="nam">token_list</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> <span class="com"># type: List['TokenOrElement']</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t833" href="#t833">833</a></span><span class="t"> <span class="nam">token_list</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_parse_str</span><span class="op">(</span><span class="nam">content</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t834" href="#t834">834</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822InterpretationProxyElement</span><span class="op">(</span><span class="nam">value_element</span><span class="op">,</span> <span class="nam">token_list</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t835" href="#t835">835</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t836" href="#t836">836</a></span><span class="t"> <span class="key">def</span> <span class="nam">_parse_str</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">content</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t837" href="#t837">837</a></span><span class="t"> <span class="com"># type: (str) -> Iterable[Union[Deb822Token, VE]]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t838" href="#t838">838</a></span><span class="t"> <span class="nam">content_len</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">content</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t839" href="#t839">839</a></span><span class="t"> <span class="nam">biter</span> <span class="op">=</span> <span class="nam">BufferingIterator</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t840" href="#t840">840</a></span><span class="t"> <span class="nam">len_check_iterator</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t841" href="#t841">841</a></span><span class="t"> <span class="nam">content</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t842" href="#t842">842</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_tokenizer</span><span class="op">(</span><span class="nam">content</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t843" href="#t843">843</a></span><span class="t"> <span class="nam">content_len</span><span class="op">=</span><span class="nam">content_len</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t844" href="#t844">844</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t845" href="#t845">845</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t846" href="#t846">846</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">len_check_iterator</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t847" href="#t847">847</a></span><span class="t"> <span class="nam">content</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t848" href="#t848">848</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_parse_stream</span><span class="op">(</span><span class="nam">biter</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t849" href="#t849">849</a></span><span class="t"> <span class="nam">content_len</span><span class="op">=</span><span class="nam">content_len</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t850" href="#t850">850</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t851" href="#t851">851</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t852" href="#t852">852</a></span><span class="t"> <span class="key">def</span> <span class="nam">interpret</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t853" href="#t853">853</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t854" href="#t854">854</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">,</span> <span class="com"># type: Deb822KeyValuePairElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t855" href="#t855">855</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t856" href="#t856">856</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t857" href="#t857">857</a></span><span class="t"> <span class="com"># type: (...) -> T</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t858" href="#t858">858</a></span><span class="t"> <span class="nam">proxy_element</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_parse_kvpair</span><span class="op">(</span><span class="nam">kvpair_element</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t859" href="#t859">859</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_high_level_interpretation</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t860" href="#t860">860</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t861" href="#t861">861</a></span><span class="t"> <span class="nam">proxy_element</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t862" href="#t862">862</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="nam">discard_comments_on_read</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t863" href="#t863">863</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t864" href="#t864">864</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t865" href="#t865">865</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t866" href="#t866">866</a></span><span class="t"><span class="key">def</span> <span class="nam">_parser_to_value_factory</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t867" href="#t867">867</a></span><span class="t"> <span class="nam">parser</span><span class="op">,</span> <span class="com"># type: StrToValueParser[VE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t868" href="#t868">868</a></span><span class="t"> <span class="nam">vtype</span><span class="op">,</span> <span class="com"># type: Type[VE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t869" href="#t869">869</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t870" href="#t870">870</a></span><span class="t"> <span class="com"># type: (...) -> Callable[[str], VE]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t871" href="#t871">871</a></span><span class="t"> <span class="key">def</span> <span class="nam">_value_factory</span><span class="op">(</span><span class="nam">v</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t872" href="#t872">872</a></span><span class="t"> <span class="com"># type: (str) -> VE</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t873" href="#t873">873</a></span><span class="t"> <span class="key">if</span> <span class="nam">v</span> <span class="op">==</span> <span class="str">""</span><span class="op">:</span> </span><span class="r"><span class="annotate short">873 ↛ 874</span><span class="annotate long">line 873 didn't jump to line 874, because the condition on line 873 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t874" href="#t874">874</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"The empty string is not a value"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t875" href="#t875">875</a></span><span class="t"> <span class="nam">token_iter</span> <span class="op">=</span> <span class="nam">iter</span><span class="op">(</span><span class="nam">parser</span><span class="op">(</span><span class="nam">v</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t876" href="#t876">876</a></span><span class="t"> <span class="nam">t1</span> <span class="op">=</span> <span class="nam">next</span><span class="op">(</span><span class="nam">token_iter</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> <span class="com"># type: Optional[Union[TokenOrElement]]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t877" href="#t877">877</a></span><span class="t"> <span class="nam">t2</span> <span class="op">=</span> <span class="nam">next</span><span class="op">(</span><span class="nam">token_iter</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t878" href="#t878">878</a></span><span class="t"> <span class="key">assert</span> <span class="nam">t1</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">,</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t879" href="#t879">879</a></span><span class="t"> <span class="str">'Bad parser - it returned None (or no TE) for "'</span> <span class="op">+</span> <span class="nam">v</span> <span class="op">+</span> <span class="str">'"'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t880" href="#t880">880</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t881" href="#t881">881</a></span><span class="t"> <span class="key">if</span> <span class="nam">t2</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">881 ↛ 882</span><span class="annotate long">line 881 didn't jump to line 882, because the condition on line 881 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t882" href="#t882">882</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="nam">textwrap</span><span class="op">.</span><span class="nam">dedent</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t883" href="#t883">883</a></span><span class="t"> <span class="str">"""\</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t884" href="#t884">884</a></span><span class="t"><span class="str"> The input "{v}" should have been exactly one element, but the parser provided at</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t885" href="#t885">885</a></span><span class="t"><span class="str"> least two. This can happen with unnecessary leading/trailing whitespace</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t886" href="#t886">886</a></span><span class="t"><span class="str"> or including commas the value for a comma list.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t887" href="#t887">887</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t888" href="#t888">888</a></span><span class="t"> <span class="op">)</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">v</span><span class="op">=</span><span class="nam">v</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t889" href="#t889">889</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="nam">msg</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t890" href="#t890">890</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">t1</span><span class="op">,</span> <span class="nam">vtype</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">890 ↛ 891</span><span class="annotate long">line 890 didn't jump to line 891, because the condition on line 890 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t891" href="#t891">891</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">t1</span><span class="op">,</span> <span class="nam">Deb822Token</span><span class="op">)</span> <span class="key">and</span> <span class="op">(</span><span class="nam">t1</span><span class="op">.</span><span class="nam">is_comment</span> <span class="key">or</span> <span class="nam">t1</span><span class="op">.</span><span class="nam">is_whitespace</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t892" href="#t892">892</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t893" href="#t893">893</a></span><span class="t"> <span class="str">'The input "{v}" is whitespace or a comment: Expected a value'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t894" href="#t894">894</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t895" href="#t895">895</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t896" href="#t896">896</a></span><span class="t"> <span class="str">'The input "{v}" should have produced a element of type {vtype_name}, but'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t897" href="#t897">897</a></span><span class="t"> <span class="str">" instead it produced {t1}"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t898" href="#t898">898</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t899" href="#t899">899</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">v</span><span class="op">=</span><span class="nam">v</span><span class="op">,</span> <span class="nam">vtype_name</span><span class="op">=</span><span class="nam">vtype</span><span class="op">.</span><span class="nam">__name__</span><span class="op">,</span> <span class="nam">t1</span><span class="op">=</span><span class="nam">t1</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t900" href="#t900">900</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t901" href="#t901">901</a></span><span class="t"> <span class="key">assert</span> <span class="nam">len</span><span class="op">(</span><span class="nam">t1</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span><span class="nam">v</span><span class="op">)</span><span class="op">,</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t902" href="#t902">902</a></span><span class="t"> <span class="str">"Bad tokenizer - the token did not cover the input text"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t903" href="#t903">903</a></span><span class="t"> <span class="str">" exactly ({t1_len} != {v_len}"</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t904" href="#t904">904</a></span><span class="t"> <span class="nam">t1_len</span><span class="op">=</span><span class="nam">len</span><span class="op">(</span><span class="nam">t1</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">)</span><span class="op">,</span> <span class="nam">v_len</span><span class="op">=</span><span class="nam">len</span><span class="op">(</span><span class="nam">v</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t905" href="#t905">905</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t906" href="#t906">906</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t907" href="#t907">907</a></span><span class="t"> <span class="key">return</span> <span class="nam">t1</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t908" href="#t908">908</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t909" href="#t909">909</a></span><span class="t"> <span class="key">return</span> <span class="nam">_value_factory</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t910" href="#t910">910</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t911" href="#t911">911</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t912" href="#t912">912</a></span><span class="t"><span class="key">class</span> <span class="nam">ListInterpretation</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t913" href="#t913">913</a></span><span class="t"> <span class="nam">GenericContentBasedInterpretation</span><span class="op">[</span><span class="nam">Deb822ParsedTokenList</span><span class="op">[</span><span class="nam">VE</span><span class="op">,</span> <span class="nam">ST</span><span class="op">]</span><span class="op">,</span> <span class="nam">VE</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t914" href="#t914">914</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t915" href="#t915">915</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t916" href="#t916">916</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t917" href="#t917">917</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t918" href="#t918">918</a></span><span class="t"> <span class="nam">tokenizer</span><span class="op">,</span> <span class="com"># type: Callable[[str], Iterable['Deb822Token']]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t919" href="#t919">919</a></span><span class="t"> <span class="nam">value_parser</span><span class="op">,</span> <span class="com"># type: StreamingValueParser[VE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t920" href="#t920">920</a></span><span class="t"> <span class="nam">vtype</span><span class="op">,</span> <span class="com"># type: Type[VE]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t921" href="#t921">921</a></span><span class="t"> <span class="nam">stype</span><span class="op">,</span> <span class="com"># type: Type[ST]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t922" href="#t922">922</a></span><span class="t"> <span class="nam">default_separator_factory</span><span class="op">,</span> <span class="com"># type: Callable[[], ST]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t923" href="#t923">923</a></span><span class="t"> <span class="nam">render_factory</span><span class="op">,</span> <span class="com"># type: Callable[[bool], Callable[[VE], str]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t924" href="#t924">924</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t925" href="#t925">925</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t926" href="#t926">926</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="nam">tokenizer</span><span class="op">,</span> <span class="nam">value_parser</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t927" href="#t927">927</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span> <span class="op">=</span> <span class="nam">vtype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t928" href="#t928">928</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_stype</span> <span class="op">=</span> <span class="nam">stype</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t929" href="#t929">929</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_default_separator_factory</span> <span class="op">=</span> <span class="nam">default_separator_factory</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t930" href="#t930">930</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_render_factory</span> <span class="op">=</span> <span class="nam">render_factory</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t931" href="#t931">931</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t932" href="#t932">932</a></span><span class="t"> <span class="key">def</span> <span class="nam">_high_level_interpretation</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t933" href="#t933">933</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t934" href="#t934">934</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">,</span> <span class="com"># type: Deb822KeyValuePairElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t935" href="#t935">935</a></span><span class="t"> <span class="nam">proxy_element</span><span class="op">,</span> <span class="com"># type: Deb822InterpretationProxyElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t936" href="#t936">936</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t937" href="#t937">937</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t938" href="#t938">938</a></span><span class="t"> <span class="com"># type: (...) -> Deb822ParsedTokenList[VE, ST]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t939" href="#t939">939</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822ParsedTokenList</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t940" href="#t940">940</a></span><span class="t"> <span class="nam">kvpair_element</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t941" href="#t941">941</a></span><span class="t"> <span class="nam">proxy_element</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t942" href="#t942">942</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_vtype</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t943" href="#t943">943</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_stype</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t944" href="#t944">944</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_parse_str</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t945" href="#t945">945</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_default_separator_factory</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t946" href="#t946">946</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_render_factory</span><span class="op">(</span><span class="nam">discard_comments_on_read</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t947" href="#t947">947</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t948" href="#t948">948</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t949" href="#t949">949</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t950" href="#t950">950</a></span><span class="t"><span class="key">def</span> <span class="nam">_parse_whitespace_list_value</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">_</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t951" href="#t951">951</a></span><span class="t"> <span class="com"># type: (Deb822Token, BufferingIterator[Deb822Token]) -> Deb822ParsedValueElement</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t952" href="#t952">952</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822ParsedValueElement</span><span class="op">(</span><span class="op">[</span><span class="nam">token</span><span class="op">]</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t953" href="#t953">953</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t954" href="#t954">954</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t955" href="#t955">955</a></span><span class="t"><span class="key">def</span> <span class="nam">_is_comma_token</span><span class="op">(</span><span class="nam">v</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t956" href="#t956">956</a></span><span class="t"> <span class="com"># type: (TokenOrElement) -> bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t957" href="#t957">957</a></span><span class="t"> <span class="com"># Consume tokens until the next comma</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t958" href="#t958">958</a></span><span class="t"> <span class="key">return</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">v</span><span class="op">,</span> <span class="nam">Deb822CommaToken</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t959" href="#t959">959</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t960" href="#t960">960</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t961" href="#t961">961</a></span><span class="t"><span class="key">def</span> <span class="nam">_parse_comma_list_value</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">buffered_iterator</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t962" href="#t962">962</a></span><span class="t"> <span class="com"># type: (Deb822Token, BufferingIterator[Deb822Token]) -> Deb822ParsedValueElement</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t963" href="#t963">963</a></span><span class="t"> <span class="nam">comma_offset</span> <span class="op">=</span> <span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">peek_find</span><span class="op">(</span><span class="nam">_is_comma_token</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t964" href="#t964">964</a></span><span class="t"> <span class="nam">value_parts</span> <span class="op">=</span> <span class="op">[</span><span class="nam">token</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t965" href="#t965">965</a></span><span class="t"> <span class="key">if</span> <span class="nam">comma_offset</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t966" href="#t966">966</a></span><span class="t"> <span class="com"># The value is followed by a comma and now we know where it ends</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t967" href="#t967">967</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">peek_many</span><span class="op">(</span><span class="nam">comma_offset</span> <span class="op">-</span> <span class="num">1</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t968" href="#t968">968</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t969" href="#t969">969</a></span><span class="t"> <span class="com"># The value is the last value there is. Consume all remaining tokens</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t970" href="#t970">970</a></span><span class="t"> <span class="com"># and then trim from the right.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t971" href="#t971">971</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">peek_buffer</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t972" href="#t972">972</a></span><span class="t"> <span class="key">while</span> <span class="nam">value_parts</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">value_parts</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822ValueToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t973" href="#t973">973</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">pop</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t974" href="#t974">974</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t975" href="#t975">975</a></span><span class="t"> <span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">consume_many</span><span class="op">(</span><span class="nam">len</span><span class="op">(</span><span class="nam">value_parts</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t976" href="#t976">976</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822ParsedValueElement</span><span class="op">(</span><span class="nam">value_parts</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t977" href="#t977">977</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t978" href="#t978">978</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t979" href="#t979">979</a></span><span class="t"><span class="key">def</span> <span class="nam">_parse_uploaders_list_value</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">buffered_iterator</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t980" href="#t980">980</a></span><span class="t"> <span class="com"># type: (Deb822Token, BufferingIterator[Deb822Token]) -> Deb822ParsedValueElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t981" href="#t981">981</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t982" href="#t982">982</a></span><span class="t"> <span class="com"># This is similar to _parse_comma_list_value *except* that there is an extra special</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t983" href="#t983">983</a></span><span class="t"> <span class="com"># case. Namely comma only counts as a true separator if it follows ">"</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t984" href="#t984">984</a></span><span class="t"> <span class="nam">value_parts</span> <span class="op">=</span> <span class="op">[</span><span class="nam">token</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t985" href="#t985">985</a></span><span class="t"> <span class="nam">comma_offset</span> <span class="op">=</span> <span class="op">-</span><span class="num">1</span> <span class="com"># type: Optional[int]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t986" href="#t986">986</a></span><span class="t"> <span class="key">while</span> <span class="nam">comma_offset</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t987" href="#t987">987</a></span><span class="t"> <span class="nam">comma_offset</span> <span class="op">=</span> <span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">peek_find</span><span class="op">(</span><span class="nam">_is_comma_token</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t988" href="#t988">988</a></span><span class="t"> <span class="key">if</span> <span class="nam">comma_offset</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t989" href="#t989">989</a></span><span class="t"> <span class="com"># The value is followed by a comma. Verify that this is a terminating</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t990" href="#t990">990</a></span><span class="t"> <span class="com"># comma (comma may appear in the name or email)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t991" href="#t991">991</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t992" href="#t992">992</a></span><span class="t"> <span class="com"># We include value_parts[-1] to easily cope with the common case of</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t993" href="#t993">993</a></span><span class="t"> <span class="com"># "foo <a@b.com>," where we will have 0 peeked element to examine.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t994" href="#t994">994</a></span><span class="t"> <span class="nam">peeked_elements</span> <span class="op">=</span> <span class="op">[</span><span class="nam">value_parts</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t995" href="#t995">995</a></span><span class="t"> <span class="nam">peeked_elements</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">peek_many</span><span class="op">(</span><span class="nam">comma_offset</span> <span class="op">-</span> <span class="num">1</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t996" href="#t996">996</a></span><span class="t"> <span class="nam">comma_was_separator</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t997" href="#t997">997</a></span><span class="t"> <span class="nam">i</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">peeked_elements</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t998" href="#t998">998</a></span><span class="t"> <span class="key">while</span> <span class="nam">i</span> <span class="op">>=</span> <span class="num">0</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t999" href="#t999">999</a></span><span class="t"> <span class="nam">token</span> <span class="op">=</span> <span class="nam">peeked_elements</span><span class="op">[</span><span class="nam">i</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1000" href="#t1000">1000</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">Deb822ValueToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1001" href="#t1001">1001</a></span><span class="t"> <span class="key">if</span> <span class="nam">token</span><span class="op">.</span><span class="nam">text</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">">"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1002" href="#t1002">1002</a></span><span class="t"> <span class="com"># The comma terminates the value</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1003" href="#t1003">1003</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">consume_many</span><span class="op">(</span><span class="nam">i</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1004" href="#t1004">1004</a></span><span class="t"> <span class="key">assert</span> <span class="nam">isinstance</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1005" href="#t1005">1005</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822ValueToken</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1006" href="#t1006">1006</a></span><span class="t"> <span class="op">)</span> <span class="key">and</span> <span class="nam">value_parts</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">.</span><span class="nam">text</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">">"</span><span class="op">)</span><span class="op">,</span> <span class="str">"Got: "</span> <span class="op">+</span> <span class="nam">str</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1007" href="#t1007">1007</a></span><span class="t"> <span class="nam">value_parts</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1008" href="#t1008">1008</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1009" href="#t1009">1009</a></span><span class="t"> <span class="nam">comma_was_separator</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1010" href="#t1010">1010</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1011" href="#t1011">1011</a></span><span class="t"> <span class="nam">i</span> <span class="op">-=</span> <span class="num">1</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1012" href="#t1012">1012</a></span><span class="t"> <span class="key">if</span> <span class="nam">comma_was_separator</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1013" href="#t1013">1013</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1014" href="#t1014">1014</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">consume_many</span><span class="op">(</span><span class="nam">comma_offset</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1015" href="#t1015">1015</a></span><span class="t"> <span class="key">assert</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">value_parts</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822CommaToken</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1016" href="#t1016">1016</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1017" href="#t1017">1017</a></span><span class="t"> <span class="com"># The value is the last value there is. Consume all remaining tokens</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1018" href="#t1018">1018</a></span><span class="t"> <span class="com"># and then trim from the right.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1019" href="#t1019">1019</a></span><span class="t"> <span class="nam">remaining_part</span> <span class="op">=</span> <span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">peek_buffer</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1020" href="#t1020">1020</a></span><span class="t"> <span class="nam">consume_elements</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">remaining_part</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1021" href="#t1021">1021</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">remaining_part</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1022" href="#t1022">1022</a></span><span class="t"> <span class="key">while</span> <span class="nam">value_parts</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">value_parts</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822ValueToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1023" href="#t1023">1023</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">.</span><span class="nam">pop</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1024" href="#t1024">1024</a></span><span class="t"> <span class="nam">consume_elements</span> <span class="op">-=</span> <span class="num">1</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1025" href="#t1025">1025</a></span><span class="t"> <span class="nam">buffered_iterator</span><span class="op">.</span><span class="nam">consume_many</span><span class="op">(</span><span class="nam">consume_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1026" href="#t1026">1026</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1027" href="#t1027">1027</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822ParsedValueElement</span><span class="op">(</span><span class="nam">value_parts</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1028" href="#t1028">1028</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1029" href="#t1029">1029</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1030" href="#t1030">1030</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822Element</span><span class="op">(</span><span class="nam">Locatable</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1031" href="#t1031">1031</a></span><span class="t"> <span class="str">"""Composite elements (consists of 1 or more tokens)"""</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1032" href="#t1032">1032</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1033" href="#t1033">1033</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span><span class="str">"_parent_element"</span><span class="op">,</span> <span class="str">"_full_size_cache"</span><span class="op">,</span> <span class="str">"__weakref__"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1034" href="#t1034">1034</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1035" href="#t1035">1035</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1036" href="#t1036">1036</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1037" href="#t1037">1037</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_parent_element</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[ReferenceType['Deb822Element']]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1038" href="#t1038">1038</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[Range]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1039" href="#t1039">1039</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1040" href="#t1040">1040</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1041" href="#t1041">1041</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t1042" href="#t1042">1042</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1043" href="#t1043">1043</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1044" href="#t1044">1044</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts_of_type</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">only_element_or_token_type</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1045" href="#t1045">1045</a></span><span class="t"> <span class="com"># type: (Type[TE]) -> Iterable[TE]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1046" href="#t1046">1046</a></span><span class="t"> <span class="key">for</span> <span class="nam">part</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1047" href="#t1047">1047</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">part</span><span class="op">,</span> <span class="nam">only_element_or_token_type</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1048" href="#t1048">1048</a></span><span class="t"> <span class="key">yield</span> <span class="nam">part</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1049" href="#t1049">1049</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1050" href="#t1050">1050</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_tokens</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1051" href="#t1051">1051</a></span><span class="t"> <span class="com"># type: () -> Iterable[Deb822Token]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1052" href="#t1052">1052</a></span><span class="t"> <span class="key">for</span> <span class="nam">part</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1053" href="#t1053">1053</a></span><span class="t"> <span class="com"># Control check to catch bugs early</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1054" href="#t1054">1054</a></span><span class="t"> <span class="key">assert</span> <span class="nam">part</span><span class="op">.</span><span class="nam">_parent_element</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1055" href="#t1055">1055</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">part</span><span class="op">,</span> <span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1056" href="#t1056">1056</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">part</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1057" href="#t1057">1057</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1058" href="#t1058">1058</a></span><span class="t"> <span class="key">yield</span> <span class="nam">part</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1059" href="#t1059">1059</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1060" href="#t1060">1060</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_recurse</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1061" href="#t1061">1061</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">only_element_or_token_type</span><span class="op">=</span><span class="key">None</span> <span class="com"># type: Optional[Type[TE]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1062" href="#t1062">1062</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1063" href="#t1063">1063</a></span><span class="t"> <span class="com"># type: (...) -> Iterable[TE]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1064" href="#t1064">1064</a></span><span class="t"> <span class="key">for</span> <span class="nam">part</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1065" href="#t1065">1065</a></span><span class="t"> <span class="key">if</span> <span class="nam">only_element_or_token_type</span> <span class="key">is</span> <span class="key">None</span> <span class="key">or</span> <span class="nam">isinstance</span><span class="op">(</span> </span><span class="r"><span class="annotate short">1065 ↛ 1068</span><span class="annotate long">line 1065 didn't jump to line 1068, because the condition on line 1065 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t1066" href="#t1066">1066</a></span><span class="t"> <span class="nam">part</span><span class="op">,</span> <span class="nam">only_element_or_token_type</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1067" href="#t1067">1067</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1068" href="#t1068">1068</a></span><span class="t"> <span class="key">yield</span> <span class="nam">cast</span><span class="op">(</span><span class="str">"TE"</span><span class="op">,</span> <span class="nam">part</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1069" href="#t1069">1069</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">part</span><span class="op">,</span> <span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1070" href="#t1070">1070</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">part</span><span class="op">.</span><span class="nam">iter_recurse</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1071" href="#t1071">1071</a></span><span class="t"> <span class="nam">only_element_or_token_type</span><span class="op">=</span><span class="nam">only_element_or_token_type</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1072" href="#t1072">1072</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1073" href="#t1073">1073</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1074" href="#t1074">1074</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1075" href="#t1075">1075</a></span><span class="t"> <span class="key">def</span> <span class="nam">is_error</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1076" href="#t1076">1076</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1077" href="#t1077">1077</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1078" href="#t1078">1078</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1079" href="#t1079">1079</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1080" href="#t1080">1080</a></span><span class="t"> <span class="key">def</span> <span class="nam">is_comment</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1081" href="#t1081">1081</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1082" href="#t1082">1082</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1083" href="#t1083">1083</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1084" href="#t1084">1084</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1085" href="#t1085">1085</a></span><span class="t"> <span class="key">def</span> <span class="nam">parent_element</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1086" href="#t1086">1086</a></span><span class="t"> <span class="com"># type: () -> Optional[Deb822Element]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1087" href="#t1087">1087</a></span><span class="t"> <span class="key">return</span> <span class="nam">resolve_ref</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_parent_element</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1088" href="#t1088">1088</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1089" href="#t1089">1089</a></span><span class="t"> <span class="op">@</span><span class="nam">parent_element</span><span class="op">.</span><span class="nam">setter</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1090" href="#t1090">1090</a></span><span class="t"> <span class="key">def</span> <span class="nam">parent_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">new_parent</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1091" href="#t1091">1091</a></span><span class="t"> <span class="com"># type: (Optional[Deb822Element]) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1092" href="#t1092">1092</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_parent_element</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1093" href="#t1093">1093</a></span><span class="t"> <span class="nam">weakref</span><span class="op">.</span><span class="nam">ref</span><span class="op">(</span><span class="nam">new_parent</span><span class="op">)</span> <span class="key">if</span> <span class="nam">new_parent</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">else</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1094" href="#t1094">1094</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1095" href="#t1095">1095</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1096" href="#t1096">1096</a></span><span class="t"> <span class="key">def</span> <span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1097" href="#t1097">1097</a></span><span class="t"> <span class="com"># type: () -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1098" href="#t1098">1098</a></span><span class="t"> <span class="key">for</span> <span class="nam">part</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1099" href="#t1099">1099</a></span><span class="t"> <span class="nam">part</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1100" href="#t1100">1100</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1101" href="#t1101">1101</a></span><span class="t"> <span class="com"># Deliberately not a "text" property, to signal that it is not necessary cheap.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1102" href="#t1102">1102</a></span><span class="t"> <span class="key">def</span> <span class="nam">convert_to_text</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1103" href="#t1103">1103</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1104" href="#t1104">1104</a></span><span class="t"> <span class="key">return</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">t</span><span class="op">.</span><span class="nam">text</span> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1105" href="#t1105">1105</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1106" href="#t1106">1106</a></span><span class="t"> <span class="key">def</span> <span class="nam">clear_parent_if_parent</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">parent</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1107" href="#t1107">1107</a></span><span class="t"> <span class="com"># type: (Deb822Element) -> None</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1108" href="#t1108">1108</a></span><span class="t"> <span class="key">if</span> <span class="nam">parent</span> <span class="key">is</span> <span class="nam">self</span><span class="op">.</span><span class="nam">parent_element</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1108 ↛ exit</span><span class="annotate long">line 1108 didn't return from function 'clear_parent_if_parent', because the condition on line 1108 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1109" href="#t1109">1109</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_parent_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1110" href="#t1110">1110</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1111" href="#t1111">1111</a></span><span class="t"> <span class="key">def</span> <span class="nam">size</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Range</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1112" href="#t1112">1112</a></span><span class="t"> <span class="nam">size_cache</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1113" href="#t1113">1113</a></span><span class="t"> <span class="key">if</span> <span class="nam">size_cache</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1114" href="#t1114">1114</a></span><span class="t"> <span class="nam">size_cache</span> <span class="op">=</span> <span class="nam">Range</span><span class="op">.</span><span class="nam">from_position_and_sizes</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1115" href="#t1115">1115</a></span><span class="t"> <span class="nam">START_POSITION</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1116" href="#t1116">1116</a></span><span class="t"> <span class="op">(</span><span class="nam">p</span><span class="op">.</span><span class="nam">size</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1117" href="#t1117">1117</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1118" href="#t1118">1118</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="nam">size_cache</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1119" href="#t1119">1119</a></span><span class="t"> <span class="key">return</span> <span class="nam">size_cache</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1120" href="#t1120">1120</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1121" href="#t1121">1121</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1122" href="#t1122">1122</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822InterpretationProxyElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1123" href="#t1123">1123</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1124" href="#t1124">1124</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span><span class="str">"parts"</span><span class="op">,</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1125" href="#t1125">1125</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1126" href="#t1126">1126</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1127" href="#t1127">1127</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">real_element</span><span class="op">:</span> <span class="nam">Deb822Element</span><span class="op">,</span> <span class="nam">parts</span><span class="op">:</span> <span class="nam">List</span><span class="op">[</span><span class="nam">TokenOrElement</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1128" href="#t1128">1128</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1129" href="#t1129">1129</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1130" href="#t1130">1130</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">real_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1131" href="#t1131">1131</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">parts</span> <span class="op">=</span> <span class="nam">parts</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1132" href="#t1132">1132</a></span><span class="t"> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">parts</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1133" href="#t1133">1133</a></span><span class="t"> <span class="nam">p</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1134" href="#t1134">1134</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1135" href="#t1135">1135</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1136" href="#t1136">1136</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1137" href="#t1137">1137</a></span><span class="t"> <span class="key">return</span> <span class="nam">iter</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">parts</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1138" href="#t1138">1138</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1139" href="#t1139">1139</a></span><span class="t"> <span class="key">def</span> <span class="nam">position_in_parent</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Position</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1140" href="#t1140">1140</a></span><span class="t"> <span class="nam">parent</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">parent_element</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1141" href="#t1141">1141</a></span><span class="t"> <span class="key">if</span> <span class="nam">parent</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1142" href="#t1142">1142</a></span><span class="t"> <span class="key">raise</span> <span class="nam">RuntimeError</span><span class="op">(</span><span class="str">"parent was garbage collected"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1143" href="#t1143">1143</a></span><span class="t"> <span class="key">return</span> <span class="nam">parent</span><span class="op">.</span><span class="nam">position_in_parent</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1144" href="#t1144">1144</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1145" href="#t1145">1145</a></span><span class="t"> <span class="key">def</span> <span class="nam">position_in_file</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Position</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1146" href="#t1146">1146</a></span><span class="t"> <span class="nam">parent</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">parent_element</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1147" href="#t1147">1147</a></span><span class="t"> <span class="key">if</span> <span class="nam">parent</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1148" href="#t1148">1148</a></span><span class="t"> <span class="key">raise</span> <span class="nam">RuntimeError</span><span class="op">(</span><span class="str">"parent was garbage collected"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1149" href="#t1149">1149</a></span><span class="t"> <span class="key">return</span> <span class="nam">parent</span><span class="op">.</span><span class="nam">position_in_file</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1150" href="#t1150">1150</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1151" href="#t1151">1151</a></span><span class="t"> <span class="key">def</span> <span class="nam">size</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Range</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1152" href="#t1152">1152</a></span><span class="t"> <span class="com"># Same as parent except we never use a cache.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1153" href="#t1153">1153</a></span><span class="t"> <span class="nam">sizes</span> <span class="op">=</span> <span class="op">(</span><span class="nam">p</span><span class="op">.</span><span class="nam">size</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1154" href="#t1154">1154</a></span><span class="t"> <span class="key">return</span> <span class="nam">Range</span><span class="op">.</span><span class="nam">from_position_and_sizes</span><span class="op">(</span><span class="nam">START_POSITION</span><span class="op">,</span> <span class="nam">sizes</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1155" href="#t1155">1155</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1156" href="#t1156">1156</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1157" href="#t1157">1157</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822ErrorElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1158" href="#t1158">1158</a></span><span class="t"> <span class="str">"""Element representing elements or tokens that are out of place</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1159" href="#t1159">1159</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1160" href="#t1160">1160</a></span><span class="t"><span class="str"> Commonly, it will just be instances of Deb822ErrorToken, but it can be other</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1161" href="#t1161">1161</a></span><span class="t"><span class="str"> things. As an example if a parser discovers out of order elements/tokens,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1162" href="#t1162">1162</a></span><span class="t"><span class="str"> it can bundle them in a Deb822ErrorElement to signal that the sequence of</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1163" href="#t1163">1163</a></span><span class="t"><span class="str"> elements/tokens are invalid (even if the tokens themselves are valid).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1164" href="#t1164">1164</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1165" href="#t1165">1165</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1166" href="#t1166">1166</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span><span class="str">"_parts"</span><span class="op">,</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1167" href="#t1167">1167</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1168" href="#t1168">1168</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">parts</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1169" href="#t1169">1169</a></span><span class="t"> <span class="com"># type: (Sequence[TokenOrElement]) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1170" href="#t1170">1170</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1171" href="#t1171">1171</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_parts</span> <span class="op">=</span> <span class="nam">tuple</span><span class="op">(</span><span class="nam">parts</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1172" href="#t1172">1172</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1173" href="#t1173">1173</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1174" href="#t1174">1174</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1175" href="#t1175">1175</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1176" href="#t1176">1176</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_parts</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1177" href="#t1177">1177</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1178" href="#t1178">1178</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1179" href="#t1179">1179</a></span><span class="t"> <span class="key">def</span> <span class="nam">is_error</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1180" href="#t1180">1180</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1181" href="#t1181">1181</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1182" href="#t1182">1182</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1183" href="#t1183">1183</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1184" href="#t1184">1184</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822ValueLineElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1185" href="#t1185">1185</a></span><span class="t"> <span class="str">"""Consists of one "line" of a value"""</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1186" href="#t1186">1186</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1187" href="#t1187">1187</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1188" href="#t1188">1188</a></span><span class="t"> <span class="str">"_comment_element"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1189" href="#t1189">1189</a></span><span class="t"> <span class="str">"_continuation_line_token"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1190" href="#t1190">1190</a></span><span class="t"> <span class="str">"_leading_whitespace_token"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1191" href="#t1191">1191</a></span><span class="t"> <span class="str">"_value_tokens"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1192" href="#t1192">1192</a></span><span class="t"> <span class="str">"_trailing_whitespace_token"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1193" href="#t1193">1193</a></span><span class="t"> <span class="str">"_newline_token"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1194" href="#t1194">1194</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1195" href="#t1195">1195</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1196" href="#t1196">1196</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1197" href="#t1197">1197</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1198" href="#t1198">1198</a></span><span class="t"> <span class="nam">comment_element</span><span class="op">,</span> <span class="com"># type: Optional[Deb822CommentElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1199" href="#t1199">1199</a></span><span class="t"> <span class="nam">continuation_line_token</span><span class="op">,</span> <span class="com"># type: Optional[Deb822ValueContinuationToken]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1200" href="#t1200">1200</a></span><span class="t"> <span class="nam">leading_whitespace_token</span><span class="op">,</span> <span class="com"># type: Optional[Deb822WhitespaceToken]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1201" href="#t1201">1201</a></span><span class="t"> <span class="nam">value_parts</span><span class="op">,</span> <span class="com"># type: List[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1202" href="#t1202">1202</a></span><span class="t"> <span class="nam">trailing_whitespace_token</span><span class="op">,</span> <span class="com"># type: Optional[Deb822WhitespaceToken]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1203" href="#t1203">1203</a></span><span class="t"> <span class="com"># only optional if it is the last line of the file and the file does not</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1204" href="#t1204">1204</a></span><span class="t"> <span class="com"># end with a newline.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1205" href="#t1205">1205</a></span><span class="t"> <span class="nam">newline_token</span><span class="op">,</span> <span class="com"># type: Optional[Deb822WhitespaceToken]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1206" href="#t1206">1206</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1207" href="#t1207">1207</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1208" href="#t1208">1208</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1209" href="#t1209">1209</a></span><span class="t"> <span class="key">if</span> <span class="nam">comment_element</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">continuation_line_token</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1209 ↛ 1210</span><span class="annotate long">line 1209 didn't jump to line 1210, because the condition on line 1209 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1210" href="#t1210">1210</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Only continuation lines can have comments"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1211" href="#t1211">1211</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span> <span class="op">=</span> <span class="nam">comment_element</span> <span class="com"># type: Optional[Deb822CommentElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1212" href="#t1212">1212</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_continuation_line_token</span> <span class="op">=</span> <span class="nam">continuation_line_token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1213" href="#t1213">1213</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_leading_whitespace_token</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1214" href="#t1214">1214</a></span><span class="t"> <span class="nam">leading_whitespace_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1215" href="#t1215">1215</a></span><span class="t"> <span class="op">)</span> <span class="com"># type: Optional[Deb822WhitespaceToken]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1216" href="#t1216">1216</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_tokens</span> <span class="op">=</span> <span class="nam">value_parts</span> <span class="com"># type: List[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1217" href="#t1217">1217</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_trailing_whitespace_token</span> <span class="op">=</span> <span class="nam">trailing_whitespace_token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1218" href="#t1218">1218</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_newline_token</span> <span class="op">=</span> <span class="nam">newline_token</span> <span class="com"># type: Optional[Deb822WhitespaceToken]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1219" href="#t1219">1219</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1220" href="#t1220">1220</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1221" href="#t1221">1221</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1222" href="#t1222">1222</a></span><span class="t"> <span class="key">def</span> <span class="nam">comment_element</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1223" href="#t1223">1223</a></span><span class="t"> <span class="com"># type: () -> Optional[Deb822CommentElement]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1224" href="#t1224">1224</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1225" href="#t1225">1225</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1226" href="#t1226">1226</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1227" href="#t1227">1227</a></span><span class="t"> <span class="key">def</span> <span class="nam">continuation_line_token</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1228" href="#t1228">1228</a></span><span class="t"> <span class="com"># type: () -> Optional[Deb822ValueContinuationToken]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1229" href="#t1229">1229</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_continuation_line_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1230" href="#t1230">1230</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1231" href="#t1231">1231</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1232" href="#t1232">1232</a></span><span class="t"> <span class="key">def</span> <span class="nam">newline_token</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1233" href="#t1233">1233</a></span><span class="t"> <span class="com"># type: () -> Optional[Deb822WhitespaceToken]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1234" href="#t1234">1234</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_newline_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1235" href="#t1235">1235</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1236" href="#t1236">1236</a></span><span class="t"> <span class="key">def</span> <span class="nam">add_newline_if_missing</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1237" href="#t1237">1237</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1238" href="#t1238">1238</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_newline_token</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1239" href="#t1239">1239</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_newline_token</span> <span class="op">=</span> <span class="nam">Deb822NewlineAfterValueToken</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1240" href="#t1240">1240</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_newline_token</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1241" href="#t1241">1241</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1242" href="#t1242">1242</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1243" href="#t1243">1243</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1244" href="#t1244">1244</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1245" href="#t1245">1245</a></span><span class="t"> <span class="key">def</span> <span class="nam">_iter_content_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1246" href="#t1246">1246</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1247" href="#t1247">1247</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_leading_whitespace_token</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1247 ↛ 1248</span><span class="annotate long">line 1247 didn't jump to line 1248, because the condition on line 1247 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1248" href="#t1248">1248</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_leading_whitespace_token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1249" href="#t1249">1249</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_tokens</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1250" href="#t1250">1250</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_trailing_whitespace_token</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1251" href="#t1251">1251</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_trailing_whitespace_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1252" href="#t1252">1252</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1253" href="#t1253">1253</a></span><span class="t"> <span class="key">def</span> <span class="nam">_iter_content_tokens</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1254" href="#t1254">1254</a></span><span class="t"> <span class="com"># type: () -> Iterable[Deb822Token]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1255" href="#t1255">1255</a></span><span class="t"> <span class="key">for</span> <span class="nam">part</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_iter_content_parts</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1256" href="#t1256">1256</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">part</span><span class="op">,</span> <span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1257" href="#t1257">1257</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">part</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1258" href="#t1258">1258</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1259" href="#t1259">1259</a></span><span class="t"> <span class="key">yield</span> <span class="nam">part</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1260" href="#t1260">1260</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1261" href="#t1261">1261</a></span><span class="t"> <span class="key">def</span> <span class="nam">convert_content_to_text</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1262" href="#t1262">1262</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1263" href="#t1263">1263</a></span><span class="t"> <span class="key">if</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1264" href="#t1264">1264</a></span><span class="t"> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_value_tokens</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1265" href="#t1265">1265</a></span><span class="t"> <span class="key">and</span> <span class="key">not</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_leading_whitespace_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1266" href="#t1266">1266</a></span><span class="t"> <span class="key">and</span> <span class="key">not</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_trailing_whitespace_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1267" href="#t1267">1267</a></span><span class="t"> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_value_tokens</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822Token</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1268" href="#t1268">1268</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1269" href="#t1269">1269</a></span><span class="t"> <span class="com"># By default, we get a single value spanning the entire line</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1270" href="#t1270">1270</a></span><span class="t"> <span class="com"># (minus continuation line and newline, but we are supposed to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1271" href="#t1271">1271</a></span><span class="t"> <span class="com"># exclude those)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1272" href="#t1272">1272</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_tokens</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">.</span><span class="nam">text</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1273" href="#t1273">1273</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1274" href="#t1274">1274</a></span><span class="t"> <span class="key">return</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">t</span><span class="op">.</span><span class="nam">text</span> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_iter_content_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1275" href="#t1275">1275</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1276" href="#t1276">1276</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1277" href="#t1277">1277</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1278" href="#t1278">1278</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1279" href="#t1279">1279</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1280" href="#t1280">1280</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_continuation_line_token</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1281" href="#t1281">1281</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_continuation_line_token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1282" href="#t1282">1282</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_iter_content_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1283" href="#t1283">1283</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_newline_token</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1283 ↛ exit</span><span class="annotate long">line 1283 didn't return from function 'iter_parts', because the condition on line 1283 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1284" href="#t1284">1284</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_newline_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1285" href="#t1285">1285</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1286" href="#t1286">1286</a></span><span class="t"> <span class="key">def</span> <span class="nam">size</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Range</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1287" href="#t1287">1287</a></span><span class="t"> <span class="key">if</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1287 ↛ 1288</span><span class="annotate long">line 1287 didn't jump to line 1288, because the condition on line 1287 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1288" href="#t1288">1288</a></span><span class="t"> <span class="key">return</span> <span class="nam">Range</span><span class="op">.</span><span class="nam">from_position_and_sizes</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1289" href="#t1289">1289</a></span><span class="t"> <span class="nam">START_POSITION</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1290" href="#t1290">1290</a></span><span class="t"> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1291" href="#t1291">1291</a></span><span class="t"> <span class="nam">p</span><span class="op">.</span><span class="nam">size</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1292" href="#t1292">1292</a></span><span class="t"> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1293" href="#t1293">1293</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">p</span><span class="op">.</span><span class="nam">is_comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1294" href="#t1294">1294</a></span><span class="t"> <span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1295" href="#t1295">1295</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1296" href="#t1296">1296</a></span><span class="t"> <span class="key">return</span> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">size</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="nam">skip_leading_comments</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1297" href="#t1297">1297</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1298" href="#t1298">1298</a></span><span class="t"> <span class="key">def</span> <span class="nam">position_in_parent</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Position</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1299" href="#t1299">1299</a></span><span class="t"> <span class="nam">base_pos</span> <span class="op">=</span> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">position_in_parent</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1300" href="#t1300">1300</a></span><span class="t"> <span class="key">if</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1301" href="#t1301">1301</a></span><span class="t"> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1302" href="#t1302">1302</a></span><span class="t"> <span class="key">if</span> <span class="nam">p</span><span class="op">.</span><span class="nam">is_comment</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1303" href="#t1303">1303</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1304" href="#t1304">1304</a></span><span class="t"> <span class="nam">non_comment_pos</span> <span class="op">=</span> <span class="nam">p</span><span class="op">.</span><span class="nam">position_in_parent</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1305" href="#t1305">1305</a></span><span class="t"> <span class="nam">base_pos</span> <span class="op">=</span> <span class="nam">non_comment_pos</span><span class="op">.</span><span class="nam">relative_to</span><span class="op">(</span><span class="nam">base_pos</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1306" href="#t1306">1306</a></span><span class="t"> <span class="key">return</span> <span class="nam">base_pos</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1307" href="#t1307">1307</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1308" href="#t1308">1308</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1309" href="#t1309">1309</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822ValueElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1310" href="#t1310">1310</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span><span class="str">"_value_entry_elements"</span><span class="op">,</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1311" href="#t1311">1311</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1312" href="#t1312">1312</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">value_entry_elements</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1313" href="#t1313">1313</a></span><span class="t"> <span class="com"># type: (Sequence[Deb822ValueLineElement]) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1314" href="#t1314">1314</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1315" href="#t1315">1315</a></span><span class="t"> <span class="com"># Split over two lines due to line length issues</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1316" href="#t1316">1316</a></span><span class="t"> <span class="nam">v</span> <span class="op">=</span> <span class="nam">tuple</span><span class="op">(</span><span class="nam">value_entry_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1317" href="#t1317">1317</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_entry_elements</span> <span class="op">=</span> <span class="nam">v</span> <span class="com"># type: Sequence[Deb822ValueLineElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1318" href="#t1318">1318</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1319" href="#t1319">1319</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1320" href="#t1320">1320</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1321" href="#t1321">1321</a></span><span class="t"> <span class="key">def</span> <span class="nam">value_lines</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1322" href="#t1322">1322</a></span><span class="t"> <span class="com"># type: () -> Sequence[Deb822ValueLineElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1323" href="#t1323">1323</a></span><span class="t"> <span class="str">"""Read-only list of value entries"""</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1324" href="#t1324">1324</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_entry_elements</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1325" href="#t1325">1325</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1326" href="#t1326">1326</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1327" href="#t1327">1327</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1328" href="#t1328">1328</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_entry_elements</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1329" href="#t1329">1329</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1330" href="#t1330">1330</a></span><span class="t"> <span class="key">def</span> <span class="nam">add_final_newline_if_missing</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1331" href="#t1331">1331</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1332" href="#t1332">1332</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_entry_elements</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1333" href="#t1333">1333</a></span><span class="t"> <span class="nam">changed</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_entry_elements</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">.</span><span class="nam">add_newline_if_missing</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1334" href="#t1334">1334</a></span><span class="t"> <span class="key">if</span> <span class="nam">changed</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1335" href="#t1335">1335</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1336" href="#t1336">1336</a></span><span class="t"> <span class="key">return</span> <span class="nam">changed</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1337" href="#t1337">1337</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1338" href="#t1338">1338</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1339" href="#t1339">1339</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1340" href="#t1340">1340</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822ParsedValueElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1341" href="#t1341">1341</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1342" href="#t1342">1342</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span><span class="str">"_text_cached"</span><span class="op">,</span> <span class="str">"_text_no_comments_cached"</span><span class="op">,</span> <span class="str">"_token_list"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1343" href="#t1343">1343</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1344" href="#t1344">1344</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">tokens</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1345" href="#t1345">1345</a></span><span class="t"> <span class="com"># type: (List[Deb822Token]) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1346" href="#t1346">1346</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1347" href="#t1347">1347</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> <span class="op">=</span> <span class="nam">tokens</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1348" href="#t1348">1348</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1349" href="#t1349">1349</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">tokens</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822ValueToken</span><span class="op">)</span> <span class="key">or</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span> </span><span class="r"><span class="annotate short">1349 ↛ 1352</span><span class="annotate long">line 1349 didn't jump to line 1352, because the condition on line 1349 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t1350" href="#t1350">1350</a></span><span class="t"> <span class="nam">tokens</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822ValueToken</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1351" href="#t1351">1351</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1352" href="#t1352">1352</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1353" href="#t1353">1353</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__class__</span><span class="op">.</span><span class="nam">__name__</span> <span class="op">+</span> <span class="str">" MUST start and end on a Deb822ValueToken"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1354" href="#t1354">1354</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1355" href="#t1355">1355</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1355 ↛ 1360</span><span class="annotate long">line 1355 didn't jump to line 1360, because the condition on line 1355 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1356" href="#t1356">1356</a></span><span class="t"> <span class="nam">token</span> <span class="op">=</span> <span class="nam">tokens</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1357" href="#t1357">1357</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_cached</span> <span class="op">=</span> <span class="nam">token</span><span class="op">.</span><span class="nam">text</span> <span class="com"># type: Optional[str]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1358" href="#t1358">1358</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> <span class="op">=</span> <span class="nam">token</span><span class="op">.</span><span class="nam">text</span> <span class="com"># type: Optional[str]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1359" href="#t1359">1359</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1360" href="#t1360">1360</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_cached</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1361" href="#t1361">1361</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1362" href="#t1362">1362</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1363" href="#t1363">1363</a></span><span class="t"> <span class="key">def</span> <span class="nam">convert_to_text</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1364" href="#t1364">1364</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1365" href="#t1365">1365</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1365 ↛ 1366</span><span class="annotate long">line 1365 didn't jump to line 1366, because the condition on line 1365 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1366" href="#t1366">1366</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> <span class="op">=</span> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1367" href="#t1367">1367</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1368" href="#t1368">1368</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1369" href="#t1369">1369</a></span><span class="t"> <span class="key">def</span> <span class="nam">convert_to_text_without_comments</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1370" href="#t1370">1370</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1371" href="#t1371">1371</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1371 ↛ 1372</span><span class="annotate long">line 1371 didn't jump to line 1372, because the condition on line 1371 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1372" href="#t1372">1372</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> <span class="op">=</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1373" href="#t1373">1373</a></span><span class="t"> <span class="nam">t</span><span class="op">.</span><span class="nam">text</span> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span> <span class="key">if</span> <span class="key">not</span> <span class="nam">t</span><span class="op">.</span><span class="nam">is_comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1374" href="#t1374">1374</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1375" href="#t1375">1375</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_text_no_comments_cached</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1376" href="#t1376">1376</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1377" href="#t1377">1377</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1378" href="#t1378">1378</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1379" href="#t1379">1379</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_list</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1380" href="#t1380">1380</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1381" href="#t1381">1381</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1382" href="#t1382">1382</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822CommentElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1383" href="#t1383">1383</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span><span class="str">"_comment_tokens"</span><span class="op">,</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1384" href="#t1384">1384</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1385" href="#t1385">1385</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">comment_tokens</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1386" href="#t1386">1386</a></span><span class="t"> <span class="com"># type: (Sequence[Deb822CommentToken]) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1387" href="#t1387">1387</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1388" href="#t1388">1388</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_tokens</span> <span class="op">=</span> <span class="nam">tuple</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1389" href="#t1389">1389</a></span><span class="t"> <span class="nam">comment_tokens</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1390" href="#t1390">1390</a></span><span class="t"> <span class="op">)</span> <span class="com"># type: Sequence[Deb822CommentToken]</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t1391" href="#t1391">1391</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">comment_tokens</span><span class="op">:</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t1392" href="#t1392">1392</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Comment elements must have at least one comment token"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1393" href="#t1393">1393</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1394" href="#t1394">1394</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1395" href="#t1395">1395</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1396" href="#t1396">1396</a></span><span class="t"> <span class="key">def</span> <span class="nam">is_comment</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1397" href="#t1397">1397</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1398" href="#t1398">1398</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1399" href="#t1399">1399</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1400" href="#t1400">1400</a></span><span class="t"> <span class="key">def</span> <span class="nam">__len__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1401" href="#t1401">1401</a></span><span class="t"> <span class="com"># type: () -> int</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1402" href="#t1402">1402</a></span><span class="t"> <span class="key">return</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_comment_tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1403" href="#t1403">1403</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1404" href="#t1404">1404</a></span><span class="t"> <span class="key">def</span> <span class="nam">__getitem__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1405" href="#t1405">1405</a></span><span class="t"> <span class="com"># type: (int) -> Deb822CommentToken</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1406" href="#t1406">1406</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_tokens</span><span class="op">[</span><span class="nam">item</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1407" href="#t1407">1407</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1408" href="#t1408">1408</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1409" href="#t1409">1409</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1410" href="#t1410">1410</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_tokens</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1411" href="#t1411">1411</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1412" href="#t1412">1412</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1413" href="#t1413">1413</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822KeyValuePairElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1414" href="#t1414">1414</a></span><span class="t"> <span class="nam">__slots__</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1415" href="#t1415">1415</a></span><span class="t"> <span class="str">"_comment_element"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1416" href="#t1416">1416</a></span><span class="t"> <span class="str">"_field_token"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1417" href="#t1417">1417</a></span><span class="t"> <span class="str">"_separator_token"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1418" href="#t1418">1418</a></span><span class="t"> <span class="str">"_value_element"</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1419" href="#t1419">1419</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1420" href="#t1420">1420</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1421" href="#t1421">1421</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1422" href="#t1422">1422</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1423" href="#t1423">1423</a></span><span class="t"> <span class="nam">comment_element</span><span class="op">,</span> <span class="com"># type: Optional[Deb822CommentElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1424" href="#t1424">1424</a></span><span class="t"> <span class="nam">field_token</span><span class="op">,</span> <span class="com"># type: Deb822FieldNameToken</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1425" href="#t1425">1425</a></span><span class="t"> <span class="nam">separator_token</span><span class="op">,</span> <span class="com"># type: Deb822FieldSeparatorToken</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1426" href="#t1426">1426</a></span><span class="t"> <span class="nam">value_element</span><span class="op">,</span> <span class="com"># type: Deb822ValueElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1427" href="#t1427">1427</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1428" href="#t1428">1428</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1429" href="#t1429">1429</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1430" href="#t1430">1430</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span> <span class="op">=</span> <span class="nam">comment_element</span> <span class="com"># type: Optional[Deb822CommentElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1431" href="#t1431">1431</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_field_token</span> <span class="op">=</span> <span class="nam">field_token</span> <span class="com"># type: Deb822FieldNameToken</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1432" href="#t1432">1432</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_separator_token</span> <span class="op">=</span> <span class="nam">separator_token</span> <span class="com"># type: Deb822FieldSeparatorToken</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1433" href="#t1433">1433</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_element</span> <span class="op">=</span> <span class="nam">value_element</span> <span class="com"># type: Deb822ValueElement</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1434" href="#t1434">1434</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1435" href="#t1435">1435</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1436" href="#t1436">1436</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1437" href="#t1437">1437</a></span><span class="t"> <span class="key">def</span> <span class="nam">field_name</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1438" href="#t1438">1438</a></span><span class="t"> <span class="com"># type: () -> _strI</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1439" href="#t1439">1439</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">field_token</span><span class="op">.</span><span class="nam">text</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1440" href="#t1440">1440</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1441" href="#t1441">1441</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1442" href="#t1442">1442</a></span><span class="t"> <span class="key">def</span> <span class="nam">field_token</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1443" href="#t1443">1443</a></span><span class="t"> <span class="com"># type: () -> Deb822FieldNameToken</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1444" href="#t1444">1444</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_field_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1445" href="#t1445">1445</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1446" href="#t1446">1446</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1447" href="#t1447">1447</a></span><span class="t"> <span class="key">def</span> <span class="nam">value_element</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1448" href="#t1448">1448</a></span><span class="t"> <span class="com"># type: () -> Deb822ValueElement</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1449" href="#t1449">1449</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_element</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1450" href="#t1450">1450</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1451" href="#t1451">1451</a></span><span class="t"> <span class="op">@</span><span class="nam">value_element</span><span class="op">.</span><span class="nam">setter</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1452" href="#t1452">1452</a></span><span class="t"> <span class="key">def</span> <span class="nam">value_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">new_value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1453" href="#t1453">1453</a></span><span class="t"> <span class="com"># type: (Deb822ValueElement) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1454" href="#t1454">1454</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1455" href="#t1455">1455</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_element</span><span class="op">.</span><span class="nam">clear_parent_if_parent</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1456" href="#t1456">1456</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_element</span> <span class="op">=</span> <span class="nam">new_value</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1457" href="#t1457">1457</a></span><span class="t"> <span class="nam">new_value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1458" href="#t1458">1458</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1459" href="#t1459">1459</a></span><span class="t"> <span class="key">def</span> <span class="nam">interpret_as</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1460" href="#t1460">1460</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1461" href="#t1461">1461</a></span><span class="t"> <span class="nam">interpreter</span><span class="op">,</span> <span class="com"># type: Interpretation[T]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1462" href="#t1462">1462</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1463" href="#t1463">1463</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1464" href="#t1464">1464</a></span><span class="t"> <span class="com"># type: (...) -> T</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1465" href="#t1465">1465</a></span><span class="t"> <span class="key">return</span> <span class="nam">interpreter</span><span class="op">.</span><span class="nam">interpret</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1466" href="#t1466">1466</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="nam">discard_comments_on_read</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1467" href="#t1467">1467</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1468" href="#t1468">1468</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1469" href="#t1469">1469</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1470" href="#t1470">1470</a></span><span class="t"> <span class="key">def</span> <span class="nam">comment_element</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1471" href="#t1471">1471</a></span><span class="t"> <span class="com"># type: () -> Optional[Deb822CommentElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1472" href="#t1472">1472</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1473" href="#t1473">1473</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1474" href="#t1474">1474</a></span><span class="t"> <span class="op">@</span><span class="nam">comment_element</span><span class="op">.</span><span class="nam">setter</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1475" href="#t1475">1475</a></span><span class="t"> <span class="key">def</span> <span class="nam">comment_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1476" href="#t1476">1476</a></span><span class="t"> <span class="com"># type: (Optional[Deb822CommentElement]) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1477" href="#t1477">1477</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1478" href="#t1478">1478</a></span><span class="t"> <span class="key">if</span> <span class="nam">value</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1478 ↛ 1479</span><span class="annotate long">line 1478 didn't jump to line 1479, because the condition on line 1478 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1479" href="#t1479">1479</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">value</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">.</span><span class="nam">text</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1480" href="#t1480">1480</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Field comments must end with a newline"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1481" href="#t1481">1481</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1481 ↛ 1482</span><span class="annotate long">line 1481 didn't jump to line 1482, because the condition on line 1481 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1482" href="#t1482">1482</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span><span class="op">.</span><span class="nam">clear_parent_if_parent</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1483" href="#t1483">1483</a></span><span class="t"> <span class="key">if</span> <span class="nam">value</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1483 ↛ 1484</span><span class="annotate long">line 1483 didn't jump to line 1484, because the condition on line 1483 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1484" href="#t1484">1484</a></span><span class="t"> <span class="nam">value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1485" href="#t1485">1485</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span> <span class="op">=</span> <span class="nam">value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1486" href="#t1486">1486</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1487" href="#t1487">1487</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1488" href="#t1488">1488</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1489" href="#t1489">1489</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1490" href="#t1490">1490</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1491" href="#t1491">1491</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_field_token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1492" href="#t1492">1492</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_separator_token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1493" href="#t1493">1493</a></span><span class="t"> <span class="key">yield</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_value_element</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1494" href="#t1494">1494</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1495" href="#t1495">1495</a></span><span class="t"> <span class="key">def</span> <span class="nam">position_in_parent</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1496" href="#t1496">1496</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1497" href="#t1497">1497</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1498" href="#t1498">1498</a></span><span class="t"> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1499" href="#t1499">1499</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">Position</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1500" href="#t1500">1500</a></span><span class="t"> <span class="nam">position</span> <span class="op">=</span> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">position_in_parent</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1501" href="#t1501">1501</a></span><span class="t"> <span class="key">if</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1501 ↛ 1505</span><span class="annotate long">line 1501 didn't jump to line 1505, because the condition on line 1501 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1502" href="#t1502">1502</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_comment_element</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1503" href="#t1503">1503</a></span><span class="t"> <span class="nam">field_pos</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_field_token</span><span class="op">.</span><span class="nam">position_in_parent</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1504" href="#t1504">1504</a></span><span class="t"> <span class="nam">position</span> <span class="op">=</span> <span class="nam">field_pos</span><span class="op">.</span><span class="nam">relative_to</span><span class="op">(</span><span class="nam">position</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1505" href="#t1505">1505</a></span><span class="t"> <span class="key">return</span> <span class="nam">position</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1506" href="#t1506">1506</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1507" href="#t1507">1507</a></span><span class="t"> <span class="key">def</span> <span class="nam">size</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Range</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1508" href="#t1508">1508</a></span><span class="t"> <span class="key">if</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1509" href="#t1509">1509</a></span><span class="t"> <span class="key">return</span> <span class="nam">Range</span><span class="op">.</span><span class="nam">from_position_and_sizes</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1510" href="#t1510">1510</a></span><span class="t"> <span class="nam">START_POSITION</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1511" href="#t1511">1511</a></span><span class="t"> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1512" href="#t1512">1512</a></span><span class="t"> <span class="nam">p</span><span class="op">.</span><span class="nam">size</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1513" href="#t1513">1513</a></span><span class="t"> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1514" href="#t1514">1514</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">p</span><span class="op">.</span><span class="nam">is_comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1515" href="#t1515">1515</a></span><span class="t"> <span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1516" href="#t1516">1516</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1517" href="#t1517">1517</a></span><span class="t"> <span class="key">return</span> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">size</span><span class="op">(</span><span class="nam">skip_leading_comments</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1518" href="#t1518">1518</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1519" href="#t1519">1519</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1520" href="#t1520">1520</a></span><span class="t"><span class="key">def</span> <span class="nam">_format_comment</span><span class="op">(</span><span class="nam">c</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1521" href="#t1521">1521</a></span><span class="t"> <span class="com"># type: (str) -> str</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1522" href="#t1522">1522</a></span><span class="t"> <span class="key">if</span> <span class="nam">c</span> <span class="op">==</span> <span class="str">""</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1522 ↛ 1524</span><span class="annotate long">line 1522 didn't jump to line 1524, because the condition on line 1522 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t1523" href="#t1523">1523</a></span><span class="t"> <span class="com"># Special-case: Empty strings are mapped to an empty comment line</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1524" href="#t1524">1524</a></span><span class="t"> <span class="key">return</span> <span class="str">"#\n"</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1525" href="#t1525">1525</a></span><span class="t"> <span class="key">if</span> <span class="str">"\n"</span> <span class="key">in</span> <span class="nam">c</span><span class="op">[</span><span class="op">:</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1525 ↛ 1526</span><span class="annotate long">line 1525 didn't jump to line 1526, because the condition on line 1525 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1526" href="#t1526">1526</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Comment lines must not have embedded newlines"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1527" href="#t1527">1527</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">c</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1527 ↛ 1529</span><span class="annotate long">line 1527 didn't jump to line 1529, because the condition on line 1527 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1528" href="#t1528">1528</a></span><span class="t"> <span class="nam">c</span> <span class="op">=</span> <span class="nam">c</span><span class="op">.</span><span class="nam">rstrip</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span> <span class="str">"\n"</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1529" href="#t1529">1529</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">c</span><span class="op">.</span><span class="nam">startswith</span><span class="op">(</span><span class="str">"#"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1529 ↛ 1531</span><span class="annotate long">line 1529 didn't jump to line 1531, because the condition on line 1529 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1530" href="#t1530">1530</a></span><span class="t"> <span class="nam">c</span> <span class="op">=</span> <span class="str">"# "</span> <span class="op">+</span> <span class="nam">c</span><span class="op">.</span><span class="nam">lstrip</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1531" href="#t1531">1531</a></span><span class="t"> <span class="key">return</span> <span class="nam">c</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1532" href="#t1532">1532</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1533" href="#t1533">1533</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1534" href="#t1534">1534</a></span><span class="t"><span class="key">def</span> <span class="nam">_unpack_key</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1535" href="#t1535">1535</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> <span class="com"># type: ParagraphKey</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1536" href="#t1536">1536</a></span><span class="t"> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1537" href="#t1537">1537</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1538" href="#t1538">1538</a></span><span class="t"> <span class="com"># type: (...) -> Tuple[_strI, Optional[int], Optional[Deb822FieldNameToken]]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1539" href="#t1539">1539</a></span><span class="t"> <span class="nam">index</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[int]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1540" href="#t1540">1540</a></span><span class="t"> <span class="nam">name_token</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[Deb822FieldNameToken]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1541" href="#t1541">1541</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">tuple</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1542" href="#t1542">1542</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">index</span> <span class="op">=</span> <span class="nam">item</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1543" href="#t1543">1543</a></span><span class="t"> <span class="key">if</span> <span class="nam">raise_if_indexed</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1543 ↛ 1550</span><span class="annotate long">line 1543 didn't jump to line 1550, because the condition on line 1543 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t1544" href="#t1544">1544</a></span><span class="t"> <span class="com"># Fudge "(key, 0)" into a "key" callers to defensively support</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1545" href="#t1545">1545</a></span><span class="t"> <span class="com"># both paragraph styles with the same key.</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1546" href="#t1546">1546</a></span><span class="t"> <span class="key">if</span> <span class="nam">index</span> <span class="op">!=</span> <span class="num">0</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1546 ↛ 1547</span><span class="annotate long">line 1546 didn't jump to line 1547, because the condition on line 1546 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1547" href="#t1547">1547</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="str">'Cannot resolve key "{key}" with index {index}. The key is not indexed'</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1548" href="#t1548">1548</a></span><span class="t"> <span class="key">raise</span> <span class="nam">KeyError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">key</span><span class="op">=</span><span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">=</span><span class="nam">index</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1549" href="#t1549">1549</a></span><span class="t"> <span class="nam">index</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1550" href="#t1550">1550</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">_strI</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1551" href="#t1551">1551</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1552" href="#t1552">1552</a></span><span class="t"> <span class="nam">index</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1553" href="#t1553">1553</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">Deb822FieldNameToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1553 ↛ 1554</span><span class="annotate long">line 1553 didn't jump to line 1554, because the condition on line 1553 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1554" href="#t1554">1554</a></span><span class="t"> <span class="nam">name_token</span> <span class="op">=</span> <span class="nam">item</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1555" href="#t1555">1555</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">name_token</span><span class="op">.</span><span class="nam">text</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1556" href="#t1556">1556</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1557" href="#t1557">1557</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">_strI</span><span class="op">(</span><span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1558" href="#t1558">1558</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1559" href="#t1559">1559</a></span><span class="t"> <span class="key">return</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">,</span> <span class="nam">name_token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1560" href="#t1560">1560</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1561" href="#t1561">1561</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1562" href="#t1562">1562</a></span><span class="t"><span class="key">def</span> <span class="nam">_convert_value_lines_to_lines</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1563" href="#t1563">1563</a></span><span class="t"> <span class="nam">value_lines</span><span class="op">,</span> <span class="com"># type: Iterable[Deb822ValueLineElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1564" href="#t1564">1564</a></span><span class="t"> <span class="nam">strip_comments</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1565" href="#t1565">1565</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1566" href="#t1566">1566</a></span><span class="t"> <span class="com"># type: (...) -> Iterable[str]</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1567" href="#t1567">1567</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">strip_comments</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1567 ↛ 1568</span><span class="annotate long">line 1567 didn't jump to line 1568, because the condition on line 1567 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1568" href="#t1568">1568</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="op">(</span><span class="nam">v</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">value_lines</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1569" href="#t1569">1569</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1570" href="#t1570">1570</a></span><span class="t"> <span class="key">for</span> <span class="nam">element</span> <span class="key">in</span> <span class="nam">value_lines</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1571" href="#t1571">1571</a></span><span class="t"> <span class="key">yield</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">x</span><span class="op">.</span><span class="nam">text</span> <span class="key">for</span> <span class="nam">x</span> <span class="key">in</span> <span class="nam">element</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span> <span class="key">if</span> <span class="key">not</span> <span class="nam">x</span><span class="op">.</span><span class="nam">is_comment</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1572" href="#t1572">1572</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1573" href="#t1573">1573</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1574" href="#t1574">1574</a></span><span class="t"><span class="key">if</span> <span class="nam">sys</span><span class="op">.</span><span class="nam">version_info</span> <span class="op">>=</span> <span class="op">(</span><span class="num">3</span><span class="op">,</span> <span class="num">9</span><span class="op">)</span> <span class="key">or</span> <span class="nam">TYPE_CHECKING</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1574 ↛ 1579</span><span class="annotate long">line 1574 didn't jump to line 1579, because the condition on line 1574 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1575" href="#t1575">1575</a></span><span class="t"> <span class="nam">_ParagraphMapping_Base</span> <span class="op">=</span> <span class="nam">collections</span><span class="op">.</span><span class="nam">abc</span><span class="op">.</span><span class="nam">Mapping</span><span class="op">[</span><span class="nam">ParagraphKey</span><span class="op">,</span> <span class="nam">T</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1576" href="#t1576">1576</a></span><span class="t"><span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1577" href="#t1577">1577</a></span><span class="t"> <span class="com"># Python 3.5 - 3.8 compat - we are not allowed to subscript the abc.Iterator</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1578" href="#t1578">1578</a></span><span class="t"> <span class="com"># - use this little hack to work around it</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1579" href="#t1579">1579</a></span><span class="t"> <span class="key">class</span> <span class="nam">_ParagraphMapping_Base</span><span class="op">(</span><span class="nam">collections</span><span class="op">.</span><span class="nam">abc</span><span class="op">.</span><span class="nam">Mapping</span><span class="op">,</span> <span class="nam">Generic</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">,</span> <span class="nam">ABC</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1580" href="#t1580">1580</a></span><span class="t"> <span class="key">pass</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1581" href="#t1581">1581</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1582" href="#t1582">1582</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1583" href="#t1583">1583</a></span><span class="t"><span class="com"># Deb822ParagraphElement uses this Mixin (by having `_paragraph` return self).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1584" href="#t1584">1584</a></span><span class="t"><span class="com"># Therefore, the Mixin needs to call the "proper" methods on the paragraph to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1585" href="#t1585">1585</a></span><span class="t"><span class="com"># avoid doing infinite recursion.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1586" href="#t1586">1586</a></span><span class="t"><span class="key">class</span> <span class="nam">AutoResolvingMixin</span><span class="op">(</span><span class="nam">Generic</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">,</span> <span class="nam">_ParagraphMapping_Base</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1587" href="#t1587">1587</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1588" href="#t1588">1588</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1589" href="#t1589">1589</a></span><span class="t"> <span class="key">def</span> <span class="nam">_auto_resolve_ambiguous_fields</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1590" href="#t1590">1590</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1591" href="#t1591">1591</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1592" href="#t1592">1592</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1593" href="#t1593">1593</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1594" href="#t1594">1594</a></span><span class="t"> <span class="key">def</span> <span class="nam">_paragraph</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1595" href="#t1595">1595</a></span><span class="t"> <span class="com"># type: () -> Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t1596" href="#t1596">1596</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1597" href="#t1597">1597</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1598" href="#t1598">1598</a></span><span class="t"> <span class="key">def</span> <span class="nam">__len__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1599" href="#t1599">1599</a></span><span class="t"> <span class="com"># type: () -> int</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1600" href="#t1600">1600</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">kvpair_count</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1601" href="#t1601">1601</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1602" href="#t1602">1602</a></span><span class="t"> <span class="key">def</span> <span class="nam">__contains__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1603" href="#t1603">1603</a></span><span class="t"> <span class="com"># type: (object) -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1604" href="#t1604">1604</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">contains_kvpair_element</span><span class="op">(</span><span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1605" href="#t1605">1605</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1606" href="#t1606">1606</a></span><span class="t"> <span class="key">def</span> <span class="nam">__iter__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1607" href="#t1607">1607</a></span><span class="t"> <span class="com"># type: () -> Iterator[ParagraphKey]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1608" href="#t1608">1608</a></span><span class="t"> <span class="key">return</span> <span class="nam">iter</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">iter_keys</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1609" href="#t1609">1609</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1610" href="#t1610">1610</a></span><span class="t"> <span class="key">def</span> <span class="nam">__getitem__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1611" href="#t1611">1611</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> T</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1612" href="#t1612">1612</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_resolve_ambiguous_fields</span> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">str</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1613" href="#t1613">1613</a></span><span class="t"> <span class="nam">v</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="num">0</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1614" href="#t1614">1614</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1615" href="#t1615">1615</a></span><span class="t"> <span class="nam">v</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1616" href="#t1616">1616</a></span><span class="t"> <span class="key">assert</span> <span class="nam">v</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1617" href="#t1617">1617</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_interpret_value</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">v</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1618" href="#t1618">1618</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1619" href="#t1619">1619</a></span><span class="t"> <span class="key">def</span> <span class="nam">__delitem__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1620" href="#t1620">1620</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1621" href="#t1621">1621</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">remove_kvpair_element</span><span class="op">(</span><span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1622" href="#t1622">1622</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1623" href="#t1623">1623</a></span><span class="t"> <span class="key">def</span> <span class="nam">_interpret_value</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1624" href="#t1624">1624</a></span><span class="t"> <span class="com"># type: (ParagraphKey, Deb822KeyValuePairElement) -> T</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t1625" href="#t1625">1625</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1626" href="#t1626">1626</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1627" href="#t1627">1627</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1628" href="#t1628">1628</a></span><span class="t"><span class="com"># Deb822ParagraphElement uses this Mixin (by having `_paragraph` return self).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1629" href="#t1629">1629</a></span><span class="t"><span class="com"># Therefore, the Mixin needs to call the "proper" methods on the paragraph to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1630" href="#t1630">1630</a></span><span class="t"><span class="com"># avoid doing infinite recursion.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1631" href="#t1631">1631</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822ParagraphToStrWrapperMixin</span><span class="op">(</span><span class="nam">AutoResolvingMixin</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="nam">ABC</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1632" href="#t1632">1632</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1633" href="#t1633">1633</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1634" href="#t1634">1634</a></span><span class="t"> <span class="key">def</span> <span class="nam">_auto_map_initial_line_whitespace</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1635" href="#t1635">1635</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1636" href="#t1636">1636</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1637" href="#t1637">1637</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1638" href="#t1638">1638</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1639" href="#t1639">1639</a></span><span class="t"> <span class="key">def</span> <span class="nam">_discard_comments_on_read</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1640" href="#t1640">1640</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1641" href="#t1641">1641</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1642" href="#t1642">1642</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1643" href="#t1643">1643</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1644" href="#t1644">1644</a></span><span class="t"> <span class="key">def</span> <span class="nam">_auto_map_final_newline_in_multiline_values</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1645" href="#t1645">1645</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1646" href="#t1646">1646</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1647" href="#t1647">1647</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1648" href="#t1648">1648</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1649" href="#t1649">1649</a></span><span class="t"> <span class="key">def</span> <span class="nam">_preserve_field_comments_on_field_updates</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1650" href="#t1650">1650</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1651" href="#t1651">1651</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1652" href="#t1652">1652</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1653" href="#t1653">1653</a></span><span class="t"> <span class="key">def</span> <span class="nam">_convert_value_to_str</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">kvpair_element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1654" href="#t1654">1654</a></span><span class="t"> <span class="com"># type: (Deb822KeyValuePairElement) -> str</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1655" href="#t1655">1655</a></span><span class="t"> <span class="nam">value_element</span> <span class="op">=</span> <span class="nam">kvpair_element</span><span class="op">.</span><span class="nam">value_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1656" href="#t1656">1656</a></span><span class="t"> <span class="nam">value_entries</span> <span class="op">=</span> <span class="nam">value_element</span><span class="op">.</span><span class="nam">value_lines</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1657" href="#t1657">1657</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">value_entries</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1658" href="#t1658">1658</a></span><span class="t"> <span class="com"># Special case single line entry (e.g. "Package: foo") as they never</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1659" href="#t1659">1659</a></span><span class="t"> <span class="com"># have comments and we can do some parts more efficient.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1660" href="#t1660">1660</a></span><span class="t"> <span class="nam">value_entry</span> <span class="op">=</span> <span class="nam">value_entries</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1661" href="#t1661">1661</a></span><span class="t"> <span class="nam">t</span> <span class="op">=</span> <span class="nam">value_entry</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1662" href="#t1662">1662</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_map_initial_line_whitespace</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1663" href="#t1663">1663</a></span><span class="t"> <span class="nam">t</span> <span class="op">=</span> <span class="nam">t</span><span class="op">.</span><span class="nam">strip</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1664" href="#t1664">1664</a></span><span class="t"> <span class="key">return</span> <span class="nam">t</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1665" href="#t1665">1665</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1666" href="#t1666">1666</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_map_initial_line_whitespace</span> <span class="key">or</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_discard_comments_on_read</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1667" href="#t1667">1667</a></span><span class="t"> <span class="nam">converter</span> <span class="op">=</span> <span class="nam">_convert_value_lines_to_lines</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1668" href="#t1668">1668</a></span><span class="t"> <span class="nam">value_entries</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1669" href="#t1669">1669</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_discard_comments_on_read</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1670" href="#t1670">1670</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1671" href="#t1671">1671</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1672" href="#t1672">1672</a></span><span class="t"> <span class="nam">auto_map_space</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_map_initial_line_whitespace</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1673" href="#t1673">1673</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1674" href="#t1674">1674</a></span><span class="t"> <span class="com"># Because we know there are more than one line, we can unconditionally inject</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1675" href="#t1675">1675</a></span><span class="t"> <span class="com"># the newline after the first line</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1676" href="#t1676">1676</a></span><span class="t"> <span class="nam">as_text</span> <span class="op">=</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1677" href="#t1677">1677</a></span><span class="t"> <span class="nam">line</span><span class="op">.</span><span class="nam">strip</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span> <span class="str">"\n"</span> <span class="key">if</span> <span class="nam">auto_map_space</span> <span class="key">and</span> <span class="nam">i</span> <span class="op">==</span> <span class="num">1</span> <span class="key">else</span> <span class="nam">line</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1678" href="#t1678">1678</a></span><span class="t"> <span class="key">for</span> <span class="nam">i</span><span class="op">,</span> <span class="nam">line</span> <span class="key">in</span> <span class="nam">enumerate</span><span class="op">(</span><span class="nam">converter</span><span class="op">,</span> <span class="nam">start</span><span class="op">=</span><span class="num">1</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1679" href="#t1679">1679</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1680" href="#t1680">1680</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1681" href="#t1681">1681</a></span><span class="t"> <span class="com"># No rewrite necessary.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1682" href="#t1682">1682</a></span><span class="t"> <span class="nam">as_text</span> <span class="op">=</span> <span class="nam">value_element</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1683" href="#t1683">1683</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1684" href="#t1684">1684</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_map_final_newline_in_multiline_values</span> <span class="key">and</span> <span class="nam">as_text</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span> <span class="op">==</span> <span class="str">"\n"</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1685" href="#t1685">1685</a></span><span class="t"> <span class="nam">as_text</span> <span class="op">=</span> <span class="nam">as_text</span><span class="op">[</span><span class="op">:</span><span class="op">-</span><span class="num">1</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1686" href="#t1686">1686</a></span><span class="t"> <span class="key">return</span> <span class="nam">as_text</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1687" href="#t1687">1687</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1688" href="#t1688">1688</a></span><span class="t"> <span class="key">def</span> <span class="nam">__setitem__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1689" href="#t1689">1689</a></span><span class="t"> <span class="com"># type: (ParagraphKey, str) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1690" href="#t1690">1690</a></span><span class="t"> <span class="nam">keep_comments</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1691" href="#t1691">1691</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_preserve_field_comments_on_field_updates</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1692" href="#t1692">1692</a></span><span class="t"> <span class="op">)</span> <span class="com"># type: Optional[bool]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1693" href="#t1693">1693</a></span><span class="t"> <span class="nam">comment</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1694" href="#t1694">1694</a></span><span class="t"> <span class="key">if</span> <span class="nam">keep_comments</span> <span class="key">and</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_resolve_ambiguous_fields</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1695" href="#t1695">1695</a></span><span class="t"> <span class="com"># For ambiguous fields, we have to resolve the original field as</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1696" href="#t1696">1696</a></span><span class="t"> <span class="com"># the set_field_* methods do not cope with ambiguous fields. This</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1697" href="#t1697">1697</a></span><span class="t"> <span class="com"># means we might as well clear the keep_comments flag as we have</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1698" href="#t1698">1698</a></span><span class="t"> <span class="com"># resolved the comment.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1699" href="#t1699">1699</a></span><span class="t"> <span class="nam">keep_comments</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1700" href="#t1700">1700</a></span><span class="t"> <span class="nam">key_lookup</span> <span class="op">=</span> <span class="nam">item</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1701" href="#t1701">1701</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">str</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1701 ↛ 1703</span><span class="annotate long">line 1701 didn't jump to line 1703, because the condition on line 1701 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1702" href="#t1702">1702</a></span><span class="t"> <span class="nam">key_lookup</span> <span class="op">=</span> <span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="num">0</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1703" href="#t1703">1703</a></span><span class="t"> <span class="nam">orig_kvpair</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="nam">key_lookup</span><span class="op">,</span> <span class="nam">use_get</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1704" href="#t1704">1704</a></span><span class="t"> <span class="key">if</span> <span class="nam">orig_kvpair</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1705" href="#t1705">1705</a></span><span class="t"> <span class="nam">comment</span> <span class="op">=</span> <span class="nam">orig_kvpair</span><span class="op">.</span><span class="nam">comment_element</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1706" href="#t1706">1706</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1707" href="#t1707">1707</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_map_initial_line_whitespace</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1708" href="#t1708">1708</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1709" href="#t1709">1709</a></span><span class="t"> <span class="nam">idx</span> <span class="op">=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">index</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1710" href="#t1710">1710</a></span><span class="t"> <span class="key">except</span> <span class="nam">ValueError</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1711" href="#t1711">1711</a></span><span class="t"> <span class="nam">idx</span> <span class="op">=</span> <span class="op">-</span><span class="num">1</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1712" href="#t1712">1712</a></span><span class="t"> <span class="key">if</span> <span class="nam">idx</span> <span class="op">==</span> <span class="op">-</span><span class="num">1</span> <span class="key">or</span> <span class="nam">idx</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span><span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1713" href="#t1713">1713</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">set_field_to_simple_value</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1714" href="#t1714">1714</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1715" href="#t1715">1715</a></span><span class="t"> <span class="nam">value</span><span class="op">.</span><span class="nam">strip</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1716" href="#t1716">1716</a></span><span class="t"> <span class="nam">preserve_original_field_comment</span><span class="op">=</span><span class="nam">keep_comments</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1717" href="#t1717">1717</a></span><span class="t"> <span class="nam">field_comment</span><span class="op">=</span><span class="nam">comment</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1718" href="#t1718">1718</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1719" href="#t1719">1719</a></span><span class="t"> <span class="key">return</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1720" href="#t1720">1720</a></span><span class="t"> <span class="com"># Regenerate the first line with normalized whitespace if necessary</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1721" href="#t1721">1721</a></span><span class="t"> <span class="nam">first_line</span><span class="op">,</span> <span class="nam">rest</span> <span class="op">=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">split</span><span class="op">(</span><span class="str">"\n"</span><span class="op">,</span> <span class="num">1</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1722" href="#t1722">1722</a></span><span class="t"> <span class="key">if</span> <span class="nam">first_line</span> <span class="key">and</span> <span class="nam">first_line</span><span class="op">[</span><span class="op">:</span><span class="num">1</span><span class="op">]</span> <span class="key">not</span> <span class="key">in</span> <span class="op">(</span><span class="str">"\t"</span><span class="op">,</span> <span class="str">" "</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1722 ↛ 1723</span><span class="annotate long">line 1722 didn't jump to line 1723, because the condition on line 1722 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1723" href="#t1723">1723</a></span><span class="t"> <span class="nam">value</span> <span class="op">=</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="op">(</span><span class="str">" "</span><span class="op">,</span> <span class="nam">first_line</span><span class="op">.</span><span class="nam">strip</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> <span class="str">"\n"</span><span class="op">,</span> <span class="nam">rest</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1724" href="#t1724">1724</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1725" href="#t1725">1725</a></span><span class="t"> <span class="nam">value</span> <span class="op">=</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="op">(</span><span class="nam">first_line</span><span class="op">,</span> <span class="str">"\n"</span><span class="op">,</span> <span class="nam">rest</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1726" href="#t1726">1726</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">value</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1727" href="#t1727">1727</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_auto_map_final_newline_in_multiline_values</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1727 ↛ 1732</span><span class="annotate long">line 1727 didn't jump to line 1732, because the condition on line 1727 was never false</span></span></p> + <p class="run"><span class="n"><a id="t1728" href="#t1728">1728</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1729" href="#t1729">1729</a></span><span class="t"> <span class="str">"Values must end with a newline (or be single line"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1730" href="#t1730">1730</a></span><span class="t"> <span class="str">" values and use the auto whitespace mapping feature)"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1731" href="#t1731">1731</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1732" href="#t1732">1732</a></span><span class="t"> <span class="nam">value</span> <span class="op">+=</span> <span class="str">"\n"</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1733" href="#t1733">1733</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_paragraph</span><span class="op">.</span><span class="nam">set_field_from_raw_string</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1734" href="#t1734">1734</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1735" href="#t1735">1735</a></span><span class="t"> <span class="nam">value</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1736" href="#t1736">1736</a></span><span class="t"> <span class="nam">preserve_original_field_comment</span><span class="op">=</span><span class="nam">keep_comments</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1737" href="#t1737">1737</a></span><span class="t"> <span class="nam">field_comment</span><span class="op">=</span><span class="nam">comment</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1738" href="#t1738">1738</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1739" href="#t1739">1739</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1740" href="#t1740">1740</a></span><span class="t"> <span class="key">def</span> <span class="nam">_interpret_value</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1741" href="#t1741">1741</a></span><span class="t"> <span class="com"># type: (ParagraphKey, Deb822KeyValuePairElement) -> str</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1742" href="#t1742">1742</a></span><span class="t"> <span class="com"># mypy is a bit dense and cannot see that T == str</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1743" href="#t1743">1743</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_convert_value_to_str</span><span class="op">(</span><span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1744" href="#t1744">1744</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1745" href="#t1745">1745</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1746" href="#t1746">1746</a></span><span class="t"><span class="key">class</span> <span class="nam">AbstractDeb822ParagraphWrapper</span><span class="op">(</span><span class="nam">AutoResolvingMixin</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">,</span> <span class="nam">ABC</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1747" href="#t1747">1747</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1748" href="#t1748">1748</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1749" href="#t1749">1749</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1750" href="#t1750">1750</a></span><span class="t"> <span class="nam">paragraph</span><span class="op">,</span> <span class="com"># type: Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1751" href="#t1751">1751</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1752" href="#t1752">1752</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1753" href="#t1753">1753</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1754" href="#t1754">1754</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1755" href="#t1755">1755</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1756" href="#t1756">1756</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__paragraph</span> <span class="op">=</span> <span class="nam">paragraph</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1757" href="#t1757">1757</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__auto_resolve_ambiguous_fields</span> <span class="op">=</span> <span class="nam">auto_resolve_ambiguous_fields</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1758" href="#t1758">1758</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__discard_comments_on_read</span> <span class="op">=</span> <span class="nam">discard_comments_on_read</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1759" href="#t1759">1759</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1760" href="#t1760">1760</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1761" href="#t1761">1761</a></span><span class="t"> <span class="key">def</span> <span class="nam">_paragraph</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1762" href="#t1762">1762</a></span><span class="t"> <span class="com"># type: () -> Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1763" href="#t1763">1763</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">__paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1764" href="#t1764">1764</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1765" href="#t1765">1765</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1766" href="#t1766">1766</a></span><span class="t"> <span class="key">def</span> <span class="nam">_discard_comments_on_read</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1767" href="#t1767">1767</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1768" href="#t1768">1768</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">__discard_comments_on_read</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1769" href="#t1769">1769</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1770" href="#t1770">1770</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1771" href="#t1771">1771</a></span><span class="t"> <span class="key">def</span> <span class="nam">_auto_resolve_ambiguous_fields</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1772" href="#t1772">1772</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1773" href="#t1773">1773</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">__auto_resolve_ambiguous_fields</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1774" href="#t1774">1774</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1775" href="#t1775">1775</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1776" href="#t1776">1776</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822InterpretingParagraphWrapper</span><span class="op">(</span><span class="nam">AbstractDeb822ParagraphWrapper</span><span class="op">[</span><span class="nam">T</span><span class="op">]</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1777" href="#t1777">1777</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1778" href="#t1778">1778</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1779" href="#t1779">1779</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1780" href="#t1780">1780</a></span><span class="t"> <span class="nam">paragraph</span><span class="op">,</span> <span class="com"># type: Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1781" href="#t1781">1781</a></span><span class="t"> <span class="nam">interpretation</span><span class="op">,</span> <span class="com"># type: Interpretation[T]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1782" href="#t1782">1782</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1783" href="#t1783">1783</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1784" href="#t1784">1784</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1785" href="#t1785">1785</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1786" href="#t1786">1786</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1787" href="#t1787">1787</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1788" href="#t1788">1788</a></span><span class="t"> <span class="nam">paragraph</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1789" href="#t1789">1789</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="nam">auto_resolve_ambiguous_fields</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1790" href="#t1790">1790</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="nam">discard_comments_on_read</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1791" href="#t1791">1791</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1792" href="#t1792">1792</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_interpretation</span> <span class="op">=</span> <span class="nam">interpretation</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1793" href="#t1793">1793</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1794" href="#t1794">1794</a></span><span class="t"> <span class="key">def</span> <span class="nam">_interpret_value</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1795" href="#t1795">1795</a></span><span class="t"> <span class="com"># type: (ParagraphKey, Deb822KeyValuePairElement) -> T</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1796" href="#t1796">1796</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_interpretation</span><span class="op">.</span><span class="nam">interpret</span><span class="op">(</span><span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1797" href="#t1797">1797</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1798" href="#t1798">1798</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1799" href="#t1799">1799</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822DictishParagraphWrapper</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1800" href="#t1800">1800</a></span><span class="t"> <span class="nam">AbstractDeb822ParagraphWrapper</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822ParagraphToStrWrapperMixin</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1801" href="#t1801">1801</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1802" href="#t1802">1802</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1803" href="#t1803">1803</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1804" href="#t1804">1804</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1805" href="#t1805">1805</a></span><span class="t"> <span class="nam">paragraph</span><span class="op">,</span> <span class="com"># type: Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1806" href="#t1806">1806</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1807" href="#t1807">1807</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1808" href="#t1808">1808</a></span><span class="t"> <span class="nam">auto_map_initial_line_whitespace</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1809" href="#t1809">1809</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1810" href="#t1810">1810</a></span><span class="t"> <span class="nam">preserve_field_comments_on_field_updates</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1811" href="#t1811">1811</a></span><span class="t"> <span class="nam">auto_map_final_newline_in_multiline_values</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1812" href="#t1812">1812</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1813" href="#t1813">1813</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1814" href="#t1814">1814</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1815" href="#t1815">1815</a></span><span class="t"> <span class="nam">paragraph</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1816" href="#t1816">1816</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="nam">auto_resolve_ambiguous_fields</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1817" href="#t1817">1817</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="nam">discard_comments_on_read</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1818" href="#t1818">1818</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1819" href="#t1819">1819</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__auto_map_initial_line_whitespace</span> <span class="op">=</span> <span class="nam">auto_map_initial_line_whitespace</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1820" href="#t1820">1820</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__preserve_field_comments_on_field_updates</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1821" href="#t1821">1821</a></span><span class="t"> <span class="nam">preserve_field_comments_on_field_updates</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1822" href="#t1822">1822</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1823" href="#t1823">1823</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">__auto_map_final_newline_in_multiline_values</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1824" href="#t1824">1824</a></span><span class="t"> <span class="nam">auto_map_final_newline_in_multiline_values</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1825" href="#t1825">1825</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1826" href="#t1826">1826</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1827" href="#t1827">1827</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1828" href="#t1828">1828</a></span><span class="t"> <span class="key">def</span> <span class="nam">_auto_map_initial_line_whitespace</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1829" href="#t1829">1829</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1830" href="#t1830">1830</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">__auto_map_initial_line_whitespace</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1831" href="#t1831">1831</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1832" href="#t1832">1832</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1833" href="#t1833">1833</a></span><span class="t"> <span class="key">def</span> <span class="nam">_preserve_field_comments_on_field_updates</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1834" href="#t1834">1834</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1835" href="#t1835">1835</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">__preserve_field_comments_on_field_updates</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1836" href="#t1836">1836</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1837" href="#t1837">1837</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1838" href="#t1838">1838</a></span><span class="t"> <span class="key">def</span> <span class="nam">_auto_map_final_newline_in_multiline_values</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1839" href="#t1839">1839</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1840" href="#t1840">1840</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">__auto_map_final_newline_in_multiline_values</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1841" href="#t1841">1841</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1842" href="#t1842">1842</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1843" href="#t1843">1843</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822ParagraphElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">,</span> <span class="nam">Deb822ParagraphToStrWrapperMixin</span><span class="op">,</span> <span class="nam">ABC</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1844" href="#t1844">1844</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1845" href="#t1845">1845</a></span><span class="t"> <span class="op">@</span><span class="nam">classmethod</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1846" href="#t1846">1846</a></span><span class="t"> <span class="key">def</span> <span class="nam">new_empty_paragraph</span><span class="op">(</span><span class="nam">cls</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1847" href="#t1847">1847</a></span><span class="t"> <span class="com"># type: () -> Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1848" href="#t1848">1848</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822NoDuplicateFieldsParagraphElement</span><span class="op">(</span><span class="op">[</span><span class="op">]</span><span class="op">,</span> <span class="nam">OrderedSet</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1849" href="#t1849">1849</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1850" href="#t1850">1850</a></span><span class="t"> <span class="op">@</span><span class="nam">classmethod</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1851" href="#t1851">1851</a></span><span class="t"> <span class="key">def</span> <span class="nam">from_dict</span><span class="op">(</span><span class="nam">cls</span><span class="op">,</span> <span class="nam">mapping</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1852" href="#t1852">1852</a></span><span class="t"> <span class="com"># type: (Mapping[str, str]) -> Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1853" href="#t1853">1853</a></span><span class="t"> <span class="nam">paragraph</span> <span class="op">=</span> <span class="nam">cls</span><span class="op">.</span><span class="nam">new_empty_paragraph</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1854" href="#t1854">1854</a></span><span class="t"> <span class="key">for</span> <span class="nam">k</span><span class="op">,</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">mapping</span><span class="op">.</span><span class="nam">items</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1855" href="#t1855">1855</a></span><span class="t"> <span class="nam">paragraph</span><span class="op">[</span><span class="nam">k</span><span class="op">]</span> <span class="op">=</span> <span class="nam">v</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1856" href="#t1856">1856</a></span><span class="t"> <span class="key">return</span> <span class="nam">paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1857" href="#t1857">1857</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1858" href="#t1858">1858</a></span><span class="t"> <span class="op">@</span><span class="nam">classmethod</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1859" href="#t1859">1859</a></span><span class="t"> <span class="key">def</span> <span class="nam">from_kvpairs</span><span class="op">(</span><span class="nam">cls</span><span class="op">,</span> <span class="nam">kvpair_elements</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1860" href="#t1860">1860</a></span><span class="t"> <span class="com"># type: (List[Deb822KeyValuePairElement]) -> Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1861" href="#t1861">1861</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">kvpair_elements</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1861 ↛ 1862</span><span class="annotate long">line 1861 didn't jump to line 1862, because the condition on line 1861 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t1862" href="#t1862">1862</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1863" href="#t1863">1863</a></span><span class="t"> <span class="str">"A paragraph must consist of at least one field/value pair"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1864" href="#t1864">1864</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1865" href="#t1865">1865</a></span><span class="t"> <span class="nam">kvpair_order</span> <span class="op">=</span> <span class="nam">OrderedSet</span><span class="op">(</span><span class="nam">kv</span><span class="op">.</span><span class="nam">field_name</span> <span class="key">for</span> <span class="nam">kv</span> <span class="key">in</span> <span class="nam">kvpair_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t1866" href="#t1866">1866</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">kvpair_order</span><span class="op">)</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span><span class="nam">kvpair_elements</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">1866 ↛ 1875</span><span class="annotate long">line 1866 didn't jump to line 1875, because the condition on line 1866 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t1867" href="#t1867">1867</a></span><span class="t"> <span class="com"># Each field occurs at most once, which is good because that</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1868" href="#t1868">1868</a></span><span class="t"> <span class="com"># means it is a valid paragraph and we can use the optimized</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1869" href="#t1869">1869</a></span><span class="t"> <span class="com"># implementation.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1870" href="#t1870">1870</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822NoDuplicateFieldsParagraphElement</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1871" href="#t1871">1871</a></span><span class="t"> <span class="nam">kvpair_elements</span><span class="op">,</span> <span class="nam">kvpair_order</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1872" href="#t1872">1872</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1873" href="#t1873">1873</a></span><span class="t"> <span class="com"># Fallback implementation, that can cope with the repeated field names</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1874" href="#t1874">1874</a></span><span class="t"> <span class="com"># at the cost of complexity.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1875" href="#t1875">1875</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822DuplicateFieldsParagraphElement</span><span class="op">(</span><span class="nam">kvpair_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1876" href="#t1876">1876</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1877" href="#t1877">1877</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1878" href="#t1878">1878</a></span><span class="t"> <span class="key">def</span> <span class="nam">has_duplicate_fields</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1879" href="#t1879">1879</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1880" href="#t1880">1880</a></span><span class="t"> <span class="str">"""Tell whether this paragraph has duplicate fields"""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t1881" href="#t1881">1881</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1882" href="#t1882">1882</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1883" href="#t1883">1883</a></span><span class="t"> <span class="key">def</span> <span class="nam">as_interpreted_dict_view</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1884" href="#t1884">1884</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1885" href="#t1885">1885</a></span><span class="t"> <span class="nam">interpretation</span><span class="op">,</span> <span class="com"># type: Interpretation[T]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1886" href="#t1886">1886</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1887" href="#t1887">1887</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1888" href="#t1888">1888</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1889" href="#t1889">1889</a></span><span class="t"> <span class="com"># type: (...) -> Deb822InterpretingParagraphWrapper[T]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1890" href="#t1890">1890</a></span><span class="t"> <span class="str">r"""Provide a Dict-like view of the paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1891" href="#t1891">1891</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1892" href="#t1892">1892</a></span><span class="t"><span class="str"> This method returns a dict-like object representing this paragraph and</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1893" href="#t1893">1893</a></span><span class="t"><span class="str"> is useful for accessing fields in a given interpretation. It is possible</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1894" href="#t1894">1894</a></span><span class="t"><span class="str"> to use multiple versions of this dict-like view with different interpretations</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1895" href="#t1895">1895</a></span><span class="t"><span class="str"> on the same paragraph at the same time (for different fields).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1896" href="#t1896">1896</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1897" href="#t1897">1897</a></span><span class="t"><span class="str"> >>> example_deb822_paragraph = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1898" href="#t1898">1898</a></span><span class="t"><span class="str"> ... Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1899" href="#t1899">1899</a></span><span class="t"><span class="str"> ... # Field comment (because it becomes just before a field)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1900" href="#t1900">1900</a></span><span class="t"><span class="str"> ... Architecture: amd64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1901" href="#t1901">1901</a></span><span class="t"><span class="str"> ... # Inline comment (associated with the next line)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1902" href="#t1902">1902</a></span><span class="t"><span class="str"> ... i386</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1903" href="#t1903">1903</a></span><span class="t"><span class="str"> ... # We also support arm</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1904" href="#t1904">1904</a></span><span class="t"><span class="str"> ... arm64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1905" href="#t1905">1905</a></span><span class="t"><span class="str"> ... armel</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1906" href="#t1906">1906</a></span><span class="t"><span class="str"> ... '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1907" href="#t1907">1907</a></span><span class="t"><span class="str"> >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines())</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1908" href="#t1908">1908</a></span><span class="t"><span class="str"> >>> paragraph = next(iter(dfile))</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1909" href="#t1909">1909</a></span><span class="t"><span class="str"> >>> list_view = paragraph.as_interpreted_dict_view(LIST_SPACE_SEPARATED_INTERPRETATION)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1910" href="#t1910">1910</a></span><span class="t"><span class="str"> >>> # With the defaults, you only deal with the semantic values</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1911" href="#t1911">1911</a></span><span class="t"><span class="str"> >>> # - no leading or trailing whitespace on the first part of the value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1912" href="#t1912">1912</a></span><span class="t"><span class="str"> >>> list(list_view["Package"])</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1913" href="#t1913">1913</a></span><span class="t"><span class="str"> ['foo']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1914" href="#t1914">1914</a></span><span class="t"><span class="str"> >>> with list_view["Architecture"] as arch_list:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1915" href="#t1915">1915</a></span><span class="t"><span class="str"> ... orig_arch_list = list(arch_list)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1916" href="#t1916">1916</a></span><span class="t"><span class="str"> ... arch_list.replace('i386', 'kfreebsd-amd64')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1917" href="#t1917">1917</a></span><span class="t"><span class="str"> >>> orig_arch_list</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1918" href="#t1918">1918</a></span><span class="t"><span class="str"> ['amd64', 'i386', 'arm64', 'armel']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1919" href="#t1919">1919</a></span><span class="t"><span class="str"> >>> list(list_view["Architecture"])</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1920" href="#t1920">1920</a></span><span class="t"><span class="str"> ['amd64', 'kfreebsd-amd64', 'arm64', 'armel']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1921" href="#t1921">1921</a></span><span class="t"><span class="str"> >>> print(paragraph.dump(), end='')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1922" href="#t1922">1922</a></span><span class="t"><span class="str"> Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1923" href="#t1923">1923</a></span><span class="t"><span class="str"> # Field comment (because it becomes just before a field)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1924" href="#t1924">1924</a></span><span class="t"><span class="str"> Architecture: amd64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1925" href="#t1925">1925</a></span><span class="t"><span class="str"> # Inline comment (associated with the next line)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1926" href="#t1926">1926</a></span><span class="t"><span class="str"> kfreebsd-amd64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1927" href="#t1927">1927</a></span><span class="t"><span class="str"> # We also support arm</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1928" href="#t1928">1928</a></span><span class="t"><span class="str"> arm64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1929" href="#t1929">1929</a></span><span class="t"><span class="str"> armel</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1930" href="#t1930">1930</a></span><span class="t"><span class="str"> >>> # Format preserved and architecture replaced</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1931" href="#t1931">1931</a></span><span class="t"><span class="str"> >>> with list_view["Architecture"] as arch_list:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1932" href="#t1932">1932</a></span><span class="t"><span class="str"> ... # Prettify the result as sorting will cause awkward whitespace</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1933" href="#t1933">1933</a></span><span class="t"><span class="str"> ... arch_list.reformat_when_finished()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1934" href="#t1934">1934</a></span><span class="t"><span class="str"> ... arch_list.sort()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1935" href="#t1935">1935</a></span><span class="t"><span class="str"> >>> print(paragraph.dump(), end='')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1936" href="#t1936">1936</a></span><span class="t"><span class="str"> Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1937" href="#t1937">1937</a></span><span class="t"><span class="str"> # Field comment (because it becomes just before a field)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1938" href="#t1938">1938</a></span><span class="t"><span class="str"> Architecture: amd64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1939" href="#t1939">1939</a></span><span class="t"><span class="str"> # We also support arm</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1940" href="#t1940">1940</a></span><span class="t"><span class="str"> arm64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1941" href="#t1941">1941</a></span><span class="t"><span class="str"> armel</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1942" href="#t1942">1942</a></span><span class="t"><span class="str"> # Inline comment (associated with the next line)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1943" href="#t1943">1943</a></span><span class="t"><span class="str"> kfreebsd-amd64</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1944" href="#t1944">1944</a></span><span class="t"><span class="str"> >>> list(list_view["Architecture"])</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1945" href="#t1945">1945</a></span><span class="t"><span class="str"> ['amd64', 'arm64', 'armel', 'kfreebsd-amd64']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1946" href="#t1946">1946</a></span><span class="t"><span class="str"> >>> # Format preserved and architecture values sorted</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1947" href="#t1947">1947</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1948" href="#t1948">1948</a></span><span class="t"><span class="str"> :param interpretation: Decides how the field values are interpreted. As an example,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1949" href="#t1949">1949</a></span><span class="t"><span class="str"> use LIST_SPACE_SEPARATED_INTERPRETATION for fields such as Architecture in the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1950" href="#t1950">1950</a></span><span class="t"><span class="str"> debian/control file.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1951" href="#t1951">1951</a></span><span class="t"><span class="str"> :param auto_resolve_ambiguous_fields: This parameter is only relevant for paragraphs</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1952" href="#t1952">1952</a></span><span class="t"><span class="str"> that contain the same field multiple times (these are generally invalid). If the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1953" href="#t1953">1953</a></span><span class="t"><span class="str"> caller requests an ambiguous field from an invalid paragraph via a plain field name,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1954" href="#t1954">1954</a></span><span class="t"><span class="str"> the return dict-like object will refuse to resolve the field (not knowing which</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1955" href="#t1955">1955</a></span><span class="t"><span class="str"> version to pick). This parameter (if set to True) instead changes the error into</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1956" href="#t1956">1956</a></span><span class="t"><span class="str"> assuming the caller wants the *first* variant.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1957" href="#t1957">1957</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1958" href="#t1958">1958</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822InterpretingParagraphWrapper</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1959" href="#t1959">1959</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1960" href="#t1960">1960</a></span><span class="t"> <span class="nam">interpretation</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1961" href="#t1961">1961</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="nam">auto_resolve_ambiguous_fields</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1962" href="#t1962">1962</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1963" href="#t1963">1963</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t1964" href="#t1964">1964</a></span><span class="t"> <span class="key">def</span> <span class="nam">configured_view</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1965" href="#t1965">1965</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1966" href="#t1966">1966</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1967" href="#t1967">1967</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1968" href="#t1968">1968</a></span><span class="t"> <span class="nam">auto_map_initial_line_whitespace</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1969" href="#t1969">1969</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1970" href="#t1970">1970</a></span><span class="t"> <span class="nam">preserve_field_comments_on_field_updates</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1971" href="#t1971">1971</a></span><span class="t"> <span class="nam">auto_map_final_newline_in_multiline_values</span><span class="op">=</span><span class="key">True</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1972" href="#t1972">1972</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1973" href="#t1973">1973</a></span><span class="t"> <span class="com"># type: (...) -> Deb822DictishParagraphWrapper</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1974" href="#t1974">1974</a></span><span class="t"> <span class="str">r"""Provide a Dict[str, str]-like view of this paragraph with non-standard parameters</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1975" href="#t1975">1975</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1976" href="#t1976">1976</a></span><span class="t"><span class="str"> This method returns a dict-like object representing this paragraph that is</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1977" href="#t1977">1977</a></span><span class="t"><span class="str"> optionally configured differently from the default view.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1978" href="#t1978">1978</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1979" href="#t1979">1979</a></span><span class="t"><span class="str"> >>> example_deb822_paragraph = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1980" href="#t1980">1980</a></span><span class="t"><span class="str"> ... Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1981" href="#t1981">1981</a></span><span class="t"><span class="str"> ... # Field comment (because it becomes just before a field)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1982" href="#t1982">1982</a></span><span class="t"><span class="str"> ... Depends: libfoo,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1983" href="#t1983">1983</a></span><span class="t"><span class="str"> ... # Inline comment (associated with the next line)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1984" href="#t1984">1984</a></span><span class="t"><span class="str"> ... libbar,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1985" href="#t1985">1985</a></span><span class="t"><span class="str"> ... '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1986" href="#t1986">1986</a></span><span class="t"><span class="str"> >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines())</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1987" href="#t1987">1987</a></span><span class="t"><span class="str"> >>> paragraph = next(iter(dfile))</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1988" href="#t1988">1988</a></span><span class="t"><span class="str"> >>> # With the defaults, you only deal with the semantic values</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1989" href="#t1989">1989</a></span><span class="t"><span class="str"> >>> # - no leading or trailing whitespace on the first part of the value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1990" href="#t1990">1990</a></span><span class="t"><span class="str"> >>> paragraph["Package"]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1991" href="#t1991">1991</a></span><span class="t"><span class="str"> 'foo'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1992" href="#t1992">1992</a></span><span class="t"><span class="str"> >>> # - no inline comments in multiline values (but whitespace will be present</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1993" href="#t1993">1993</a></span><span class="t"><span class="str"> >>> # subsequent lines.)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1994" href="#t1994">1994</a></span><span class="t"><span class="str"> >>> print(paragraph["Depends"])</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1995" href="#t1995">1995</a></span><span class="t"><span class="str"> libfoo,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1996" href="#t1996">1996</a></span><span class="t"><span class="str"> libbar,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1997" href="#t1997">1997</a></span><span class="t"><span class="str"> >>> paragraph['Foo'] = 'bar'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1998" href="#t1998">1998</a></span><span class="t"><span class="str"> >>> paragraph.get('Foo')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t1999" href="#t1999">1999</a></span><span class="t"><span class="str"> 'bar'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2000" href="#t2000">2000</a></span><span class="t"><span class="str"> >>> paragraph.get('Unknown-Field') is None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2001" href="#t2001">2001</a></span><span class="t"><span class="str"> True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2002" href="#t2002">2002</a></span><span class="t"><span class="str"> >>> # But you get asymmetric behaviour with set vs. get</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2003" href="#t2003">2003</a></span><span class="t"><span class="str"> >>> paragraph['Foo'] = ' bar\n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2004" href="#t2004">2004</a></span><span class="t"><span class="str"> >>> paragraph['Foo']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2005" href="#t2005">2005</a></span><span class="t"><span class="str"> 'bar'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2006" href="#t2006">2006</a></span><span class="t"><span class="str"> >>> paragraph['Bar'] = ' bar\n#Comment\n another value\n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2007" href="#t2007">2007</a></span><span class="t"><span class="str"> >>> # Note that the whitespace on the first line has been normalized.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2008" href="#t2008">2008</a></span><span class="t"><span class="str"> >>> print("Bar: " + paragraph['Bar'])</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2009" href="#t2009">2009</a></span><span class="t"><span class="str"> Bar: bar</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2010" href="#t2010">2010</a></span><span class="t"><span class="str"> another value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2011" href="#t2011">2011</a></span><span class="t"><span class="str"> >>> # The comment is present (in case you where wondering)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2012" href="#t2012">2012</a></span><span class="t"><span class="str"> >>> print(paragraph.get_kvpair_element('Bar').convert_to_text(), end='')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2013" href="#t2013">2013</a></span><span class="t"><span class="str"> Bar: bar</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2014" href="#t2014">2014</a></span><span class="t"><span class="str"> #Comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2015" href="#t2015">2015</a></span><span class="t"><span class="str"> another value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2016" href="#t2016">2016</a></span><span class="t"><span class="str"> >>> # On the other hand, you can choose to see the values as they are</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2017" href="#t2017">2017</a></span><span class="t"><span class="str"> >>> # - We will just reset the paragraph as a "nothing up my sleeve"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2018" href="#t2018">2018</a></span><span class="t"><span class="str"> >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines())</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2019" href="#t2019">2019</a></span><span class="t"><span class="str"> >>> paragraph = next(iter(dfile))</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2020" href="#t2020">2020</a></span><span class="t"><span class="str"> >>> nonstd_dictview = paragraph.configured_view(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2021" href="#t2021">2021</a></span><span class="t"><span class="str"> ... discard_comments_on_read=False,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2022" href="#t2022">2022</a></span><span class="t"><span class="str"> ... auto_map_initial_line_whitespace=False,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2023" href="#t2023">2023</a></span><span class="t"><span class="str"> ... # For paragraphs with duplicate fields, you can choose to get an error</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2024" href="#t2024">2024</a></span><span class="t"><span class="str"> ... # rather than the dict picking the first value available.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2025" href="#t2025">2025</a></span><span class="t"><span class="str"> ... auto_resolve_ambiguous_fields=False,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2026" href="#t2026">2026</a></span><span class="t"><span class="str"> ... auto_map_final_newline_in_multiline_values=False,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2027" href="#t2027">2027</a></span><span class="t"><span class="str"> ... )</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2028" href="#t2028">2028</a></span><span class="t"><span class="str"> >>> # Because we have reset the state, Foo and Bar are no longer there.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2029" href="#t2029">2029</a></span><span class="t"><span class="str"> >>> 'Bar' not in paragraph and 'Foo' not in paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2030" href="#t2030">2030</a></span><span class="t"><span class="str"> True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2031" href="#t2031">2031</a></span><span class="t"><span class="str"> >>> # We can now see the comments (discard_comments_on_read=False)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2032" href="#t2032">2032</a></span><span class="t"><span class="str"> >>> # (The leading whitespace in front of "libfoo" is due to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2033" href="#t2033">2033</a></span><span class="t"><span class="str"> >>> # auto_map_initial_line_whitespace=False)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2034" href="#t2034">2034</a></span><span class="t"><span class="str"> >>> print(nonstd_dictview["Depends"], end='')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2035" href="#t2035">2035</a></span><span class="t"><span class="str"> libfoo,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2036" href="#t2036">2036</a></span><span class="t"><span class="str"> # Inline comment (associated with the next line)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2037" href="#t2037">2037</a></span><span class="t"><span class="str"> libbar,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2038" href="#t2038">2038</a></span><span class="t"><span class="str"> >>> # And all the optional whitespace on the first value line</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2039" href="#t2039">2039</a></span><span class="t"><span class="str"> >>> # (auto_map_initial_line_whitespace=False)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2040" href="#t2040">2040</a></span><span class="t"><span class="str"> >>> nonstd_dictview["Package"] == ' foo\n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2041" href="#t2041">2041</a></span><span class="t"><span class="str"> True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2042" href="#t2042">2042</a></span><span class="t"><span class="str"> >>> # ... which will give you symmetric behaviour with set vs. get</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2043" href="#t2043">2043</a></span><span class="t"><span class="str"> >>> nonstd_dictview['Foo'] = ' bar \n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2044" href="#t2044">2044</a></span><span class="t"><span class="str"> >>> nonstd_dictview['Foo']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2045" href="#t2045">2045</a></span><span class="t"><span class="str"> ' bar \n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2046" href="#t2046">2046</a></span><span class="t"><span class="str"> >>> nonstd_dictview['Bar'] = ' bar \n#Comment\n another value\n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2047" href="#t2047">2047</a></span><span class="t"><span class="str"> >>> nonstd_dictview['Bar']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2048" href="#t2048">2048</a></span><span class="t"><span class="str"> ' bar \n#Comment\n another value\n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2049" href="#t2049">2049</a></span><span class="t"><span class="str"> >>> # But then you get no help either.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2050" href="#t2050">2050</a></span><span class="t"><span class="str"> >>> try:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2051" href="#t2051">2051</a></span><span class="t"><span class="str"> ... nonstd_dictview["Baz"] = "foo"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2052" href="#t2052">2052</a></span><span class="t"><span class="str"> ... except ValueError:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2053" href="#t2053">2053</a></span><span class="t"><span class="str"> ... print("Rejected")</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2054" href="#t2054">2054</a></span><span class="t"><span class="str"> Rejected</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2055" href="#t2055">2055</a></span><span class="t"><span class="str"> >>> # With auto_map_initial_line_whitespace=False, you have to include minimum a newline</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2056" href="#t2056">2056</a></span><span class="t"><span class="str"> >>> nonstd_dictview["Baz"] = "foo\n"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2057" href="#t2057">2057</a></span><span class="t"><span class="str"> >>> # The absence of leading whitespace gives you the terse variant at the expensive</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2058" href="#t2058">2058</a></span><span class="t"><span class="str"> >>> # readability</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2059" href="#t2059">2059</a></span><span class="t"><span class="str"> >>> paragraph.get_kvpair_element('Baz').convert_to_text()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2060" href="#t2060">2060</a></span><span class="t"><span class="str"> 'Baz:foo\n'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2061" href="#t2061">2061</a></span><span class="t"><span class="str"> >>> # But because they are views, changes performed via one view is visible in the other</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2062" href="#t2062">2062</a></span><span class="t"><span class="str"> >>> paragraph['Foo']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2063" href="#t2063">2063</a></span><span class="t"><span class="str"> 'bar'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2064" href="#t2064">2064</a></span><span class="t"><span class="str"> >>> # The views show the values according to their own rules. Therefore, there is an</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2065" href="#t2065">2065</a></span><span class="t"><span class="str"> >>> # asymmetric between paragraph['Foo'] and nonstd_dictview['Foo']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2066" href="#t2066">2066</a></span><span class="t"><span class="str"> >>> # Nevertheless, you can read or write the fields via either - enabling you to use</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2067" href="#t2067">2067</a></span><span class="t"><span class="str"> >>> # the view that best suit your use-case for the given field.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2068" href="#t2068">2068</a></span><span class="t"><span class="str"> >>> 'Baz' in paragraph and nonstd_dictview.get('Baz') is not None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2069" href="#t2069">2069</a></span><span class="t"><span class="str"> True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2070" href="#t2070">2070</a></span><span class="t"><span class="str"> >>> # Deletion via the view also works</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2071" href="#t2071">2071</a></span><span class="t"><span class="str"> >>> del nonstd_dictview['Baz']</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2072" href="#t2072">2072</a></span><span class="t"><span class="str"> >>> 'Baz' not in paragraph and nonstd_dictview.get('Baz') is None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2073" href="#t2073">2073</a></span><span class="t"><span class="str"> True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2074" href="#t2074">2074</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2075" href="#t2075">2075</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2076" href="#t2076">2076</a></span><span class="t"><span class="str"> :param discard_comments_on_read: When getting a field value from the dict,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2077" href="#t2077">2077</a></span><span class="t"><span class="str"> this parameter decides how in-line comments are handled. When setting</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2078" href="#t2078">2078</a></span><span class="t"><span class="str"> the value, inline comments are still allowed and will be retained.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2079" href="#t2079">2079</a></span><span class="t"><span class="str"> However, keep in mind that this option makes getter and setter asymmetric</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2080" href="#t2080">2080</a></span><span class="t"><span class="str"> as a "get" following a "set" with inline comments will omit the comments</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2081" href="#t2081">2081</a></span><span class="t"><span class="str"> even if they are there (see the code example).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2082" href="#t2082">2082</a></span><span class="t"><span class="str"> :param auto_map_initial_line_whitespace: Special-case the first value line</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2083" href="#t2083">2083</a></span><span class="t"><span class="str"> by trimming unnecessary whitespace leaving only the value. For single-line</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2084" href="#t2084">2084</a></span><span class="t"><span class="str"> values, all space including newline is pruned. For multi-line values, the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2085" href="#t2085">2085</a></span><span class="t"><span class="str"> newline is preserved / needed to distinguish the first line from the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2086" href="#t2086">2086</a></span><span class="t"><span class="str"> following lines. When setting a value, this option normalizes the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2087" href="#t2087">2087</a></span><span class="t"><span class="str"> whitespace of the initial line of the value field.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2088" href="#t2088">2088</a></span><span class="t"><span class="str"> When this option is set to True makes the dictionary behave more like the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2089" href="#t2089">2089</a></span><span class="t"><span class="str"> original Deb822 module.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2090" href="#t2090">2090</a></span><span class="t"><span class="str"> :param preserve_field_comments_on_field_updates: Whether to preserve the field</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2091" href="#t2091">2091</a></span><span class="t"><span class="str"> comments when mutating the field.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2092" href="#t2092">2092</a></span><span class="t"><span class="str"> :param auto_resolve_ambiguous_fields: This parameter is only relevant for paragraphs</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2093" href="#t2093">2093</a></span><span class="t"><span class="str"> that contain the same field multiple times (these are generally invalid). If the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2094" href="#t2094">2094</a></span><span class="t"><span class="str"> caller requests an ambiguous field from an invalid paragraph via a plain field name,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2095" href="#t2095">2095</a></span><span class="t"><span class="str"> the return dict-like object will refuse to resolve the field (not knowing which</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2096" href="#t2096">2096</a></span><span class="t"><span class="str"> version to pick). This parameter (if set to True) instead changes the error into</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2097" href="#t2097">2097</a></span><span class="t"><span class="str"> assuming the caller wants the *first* variant.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2098" href="#t2098">2098</a></span><span class="t"><span class="str"> :param auto_map_final_newline_in_multiline_values: This parameter controls whether</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2099" href="#t2099">2099</a></span><span class="t"><span class="str"> a multiline field with have / need a trailing newline. If True, the trailing</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2100" href="#t2100">2100</a></span><span class="t"><span class="str"> newline is hidden on get and automatically added in set (if missing).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2101" href="#t2101">2101</a></span><span class="t"><span class="str"> When this option is set to True makes the dictionary behave more like the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2102" href="#t2102">2102</a></span><span class="t"><span class="str"> original Deb822 module.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2103" href="#t2103">2103</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2104" href="#t2104">2104</a></span><span class="t"> <span class="key">return</span> <span class="nam">Deb822DictishParagraphWrapper</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2105" href="#t2105">2105</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2106" href="#t2106">2106</a></span><span class="t"> <span class="nam">discard_comments_on_read</span><span class="op">=</span><span class="nam">discard_comments_on_read</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2107" href="#t2107">2107</a></span><span class="t"> <span class="nam">auto_map_initial_line_whitespace</span><span class="op">=</span><span class="nam">auto_map_initial_line_whitespace</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2108" href="#t2108">2108</a></span><span class="t"> <span class="nam">auto_resolve_ambiguous_fields</span><span class="op">=</span><span class="nam">auto_resolve_ambiguous_fields</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2109" href="#t2109">2109</a></span><span class="t"> <span class="nam">preserve_field_comments_on_field_updates</span><span class="op">=</span><span class="nam">preserve_field_comments_on_field_updates</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2110" href="#t2110">2110</a></span><span class="t"> <span class="nam">auto_map_final_newline_in_multiline_values</span><span class="op">=</span><span class="nam">auto_map_final_newline_in_multiline_values</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2111" href="#t2111">2111</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2112" href="#t2112">2112</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2113" href="#t2113">2113</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2114" href="#t2114">2114</a></span><span class="t"> <span class="key">def</span> <span class="nam">_paragraph</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2115" href="#t2115">2115</a></span><span class="t"> <span class="com"># type: () -> Deb822ParagraphElement</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2116" href="#t2116">2116</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2117" href="#t2117">2117</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2118" href="#t2118">2118</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_last</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2119" href="#t2119">2119</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2120" href="#t2120">2120</a></span><span class="t"> <span class="str">"""Re-order the given field so it is "last" in the paragraph"""</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2121" href="#t2121">2121</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2122" href="#t2122">2122</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2123" href="#t2123">2123</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_first</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2124" href="#t2124">2124</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2125" href="#t2125">2125</a></span><span class="t"> <span class="str">"""Re-order the given field so it is "first" in the paragraph"""</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2126" href="#t2126">2126</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2127" href="#t2127">2127</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2128" href="#t2128">2128</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_before</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">,</span> <span class="nam">reference_field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2129" href="#t2129">2129</a></span><span class="t"> <span class="com"># type: (ParagraphKey, ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2130" href="#t2130">2130</a></span><span class="t"> <span class="str">"""Re-order the given field so appears directly after the reference field in the paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2131" href="#t2131">2131</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2132" href="#t2132">2132</a></span><span class="t"><span class="str"> The reference field must be present."""</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2133" href="#t2133">2133</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2134" href="#t2134">2134</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2135" href="#t2135">2135</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_after</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">,</span> <span class="nam">reference_field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2136" href="#t2136">2136</a></span><span class="t"> <span class="com"># type: (ParagraphKey, ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2137" href="#t2137">2137</a></span><span class="t"> <span class="str">"""Re-order the given field so appears directly before the reference field in the paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2138" href="#t2138">2138</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2139" href="#t2139">2139</a></span><span class="t"><span class="str"> The reference field must be present.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2140" href="#t2140">2140</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2141" href="#t2141">2141</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2142" href="#t2142">2142</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2143" href="#t2143">2143</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2144" href="#t2144">2144</a></span><span class="t"> <span class="key">def</span> <span class="nam">kvpair_count</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2145" href="#t2145">2145</a></span><span class="t"> <span class="com"># type: () -> int</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2146" href="#t2146">2146</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2147" href="#t2147">2147</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2148" href="#t2148">2148</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_keys</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2149" href="#t2149">2149</a></span><span class="t"> <span class="com"># type: () -> Iterable[ParagraphKey]</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2150" href="#t2150">2150</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2151" href="#t2151">2151</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2152" href="#t2152">2152</a></span><span class="t"> <span class="key">def</span> <span class="nam">contains_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2153" href="#t2153">2153</a></span><span class="t"> <span class="com"># type: (object) -> bool</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2154" href="#t2154">2154</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2155" href="#t2155">2155</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2156" href="#t2156">2156</a></span><span class="t"> <span class="key">def</span> <span class="nam">get_kvpair_element</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2157" href="#t2157">2157</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2158" href="#t2158">2158</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> <span class="com"># type: ParagraphKey</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2159" href="#t2159">2159</a></span><span class="t"> <span class="nam">use_get</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2160" href="#t2160">2160</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2161" href="#t2161">2161</a></span><span class="t"> <span class="com"># type: (...) -> Optional[Deb822KeyValuePairElement]</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2162" href="#t2162">2162</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2163" href="#t2163">2163</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2164" href="#t2164">2164</a></span><span class="t"> <span class="key">def</span> <span class="nam">set_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2165" href="#t2165">2165</a></span><span class="t"> <span class="com"># type: (ParagraphKey, Deb822KeyValuePairElement) -> None</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2166" href="#t2166">2166</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2167" href="#t2167">2167</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2168" href="#t2168">2168</a></span><span class="t"> <span class="key">def</span> <span class="nam">remove_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2169" href="#t2169">2169</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2170" href="#t2170">2170</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2171" href="#t2171">2171</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2172" href="#t2172">2172</a></span><span class="t"> <span class="key">def</span> <span class="nam">sort_fields</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2173" href="#t2173">2173</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">None</span> <span class="com"># type: Optional[Callable[[str], Any]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2174" href="#t2174">2174</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2175" href="#t2175">2175</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2176" href="#t2176">2176</a></span><span class="t"> <span class="str">"""Re-order all fields</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2177" href="#t2177">2177</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2178" href="#t2178">2178</a></span><span class="t"><span class="str"> :param key: Provide a key function (same semantics as for sorted). Keep in mind that</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2179" href="#t2179">2179</a></span><span class="t"><span class="str"> the module preserve the cases for field names - in generally, callers are recommended</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2180" href="#t2180">2180</a></span><span class="t"><span class="str"> to use "lower()" to normalize the case.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2181" href="#t2181">2181</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2182" href="#t2182">2182</a></span><span class="t"> <span class="key">raise</span> <span class="nam">NotImplementedError</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2183" href="#t2183">2183</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2184" href="#t2184">2184</a></span><span class="t"> <span class="key">def</span> <span class="nam">set_field_to_simple_value</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2185" href="#t2185">2185</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2186" href="#t2186">2186</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> <span class="com"># type: ParagraphKey</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2187" href="#t2187">2187</a></span><span class="t"> <span class="nam">simple_value</span><span class="op">,</span> <span class="com"># type: str</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2188" href="#t2188">2188</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2189" href="#t2189">2189</a></span><span class="t"> <span class="nam">preserve_original_field_comment</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> <span class="com"># type: Optional[bool]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2190" href="#t2190">2190</a></span><span class="t"> <span class="nam">field_comment</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> <span class="com"># type: Optional[Commentish]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2191" href="#t2191">2191</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2192" href="#t2192">2192</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t2193" href="#t2193">2193</a></span><span class="t"> <span class="str">r"""Sets a field in this paragraph to a simple "word" or "phrase"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2194" href="#t2194">2194</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2195" href="#t2195">2195</a></span><span class="t"><span class="str"> In many cases, it is better for callers to just use the paragraph as</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2196" href="#t2196">2196</a></span><span class="t"><span class="str"> if it was a dictionary. However, this method does enable to you choose</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2197" href="#t2197">2197</a></span><span class="t"><span class="str"> the field comment (if any), which can be a reason for using it.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2198" href="#t2198">2198</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2199" href="#t2199">2199</a></span><span class="t"><span class="str"> This is suitable for "simple" fields like "Package". Example:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2200" href="#t2200">2200</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2201" href="#t2201">2201</a></span><span class="t"><span class="str"> >>> example_deb822_paragraph = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2202" href="#t2202">2202</a></span><span class="t"><span class="str"> ... Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2203" href="#t2203">2203</a></span><span class="t"><span class="str"> ... '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2204" href="#t2204">2204</a></span><span class="t"><span class="str"> >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines())</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2205" href="#t2205">2205</a></span><span class="t"><span class="str"> >>> p = next(iter(dfile))</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2206" href="#t2206">2206</a></span><span class="t"><span class="str"> >>> p.set_field_to_simple_value("Package", "mscgen")</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2207" href="#t2207">2207</a></span><span class="t"><span class="str"> >>> p.set_field_to_simple_value("Architecture", "linux-any kfreebsd-any",</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2208" href="#t2208">2208</a></span><span class="t"><span class="str"> ... field_comment=['Only ported to linux and kfreebsd'])</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2209" href="#t2209">2209</a></span><span class="t"><span class="str"> >>> p.set_field_to_simple_value("Priority", "optional")</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2210" href="#t2210">2210</a></span><span class="t"><span class="str"> >>> print(p.dump(), end='')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2211" href="#t2211">2211</a></span><span class="t"><span class="str"> Package: mscgen</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2212" href="#t2212">2212</a></span><span class="t"><span class="str"> # Only ported to linux and kfreebsd</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2213" href="#t2213">2213</a></span><span class="t"><span class="str"> Architecture: linux-any kfreebsd-any</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2214" href="#t2214">2214</a></span><span class="t"><span class="str"> Priority: optional</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2215" href="#t2215">2215</a></span><span class="t"><span class="str"> >>> # Values are formatted nicely by default, but it does not work with</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2216" href="#t2216">2216</a></span><span class="t"><span class="str"> >>> # multi-line values</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2217" href="#t2217">2217</a></span><span class="t"><span class="str"> >>> p.set_field_to_simple_value("Foo", "bar\nbin\n")</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2218" href="#t2218">2218</a></span><span class="t"><span class="str"> Traceback (most recent call last):</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2219" href="#t2219">2219</a></span><span class="t"><span class="str"> ...</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2220" href="#t2220">2220</a></span><span class="t"><span class="str"> ValueError: Cannot use set_field_to_simple_value for values with newlines</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2221" href="#t2221">2221</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2222" href="#t2222">2222</a></span><span class="t"><span class="str"> :param item: Name of the field to set. If the paragraph already</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2223" href="#t2223">2223</a></span><span class="t"><span class="str"> contains the field, then it will be replaced. If the field exists,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2224" href="#t2224">2224</a></span><span class="t"><span class="str"> then it will preserve its order in the paragraph. Otherwise, it is</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2225" href="#t2225">2225</a></span><span class="t"><span class="str"> added to the end of the paragraph.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2226" href="#t2226">2226</a></span><span class="t"><span class="str"> Note this can be a "paragraph key", which enables you to control</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2227" href="#t2227">2227</a></span><span class="t"><span class="str"> *which* instance of a field is being replaced (in case of duplicate</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2228" href="#t2228">2228</a></span><span class="t"><span class="str"> fields).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2229" href="#t2229">2229</a></span><span class="t"><span class="str"> :param simple_value: The text to use as the value. The value must not</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2230" href="#t2230">2230</a></span><span class="t"><span class="str"> contain newlines. Leading and trailing will be stripped but space</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2231" href="#t2231">2231</a></span><span class="t"><span class="str"> within the value is preserved. The value cannot contain comments</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2232" href="#t2232">2232</a></span><span class="t"><span class="str"> (i.e. if the "#" token appears in the value, then it is considered</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2233" href="#t2233">2233</a></span><span class="t"><span class="str"> a value rather than "start of a comment)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2234" href="#t2234">2234</a></span><span class="t"><span class="str"> :param preserve_original_field_comment: See the description for the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2235" href="#t2235">2235</a></span><span class="t"><span class="str"> parameter with the same name in the set_field_from_raw_string method.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2236" href="#t2236">2236</a></span><span class="t"><span class="str"> :param field_comment: See the description for the parameter with the same</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2237" href="#t2237">2237</a></span><span class="t"><span class="str"> name in the set_field_from_raw_string method.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2238" href="#t2238">2238</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2239" href="#t2239">2239</a></span><span class="t"> <span class="key">if</span> <span class="str">"\n"</span> <span class="key">in</span> <span class="nam">simple_value</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2240" href="#t2240">2240</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2241" href="#t2241">2241</a></span><span class="t"> <span class="str">"Cannot use set_field_to_simple_value for values with newlines"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2242" href="#t2242">2242</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2243" href="#t2243">2243</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2244" href="#t2244">2244</a></span><span class="t"> <span class="com"># Reformat it with a leading space and trailing newline. The latter because it is</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2245" href="#t2245">2245</a></span><span class="t"> <span class="com"># necessary if there are any fields after it and the former because it looks nicer so</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2246" href="#t2246">2246</a></span><span class="t"> <span class="com"># have single space after the field separator</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2247" href="#t2247">2247</a></span><span class="t"> <span class="nam">stripped</span> <span class="op">=</span> <span class="nam">simple_value</span><span class="op">.</span><span class="nam">strip</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2248" href="#t2248">2248</a></span><span class="t"> <span class="key">if</span> <span class="nam">stripped</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2248 ↛ 2252</span><span class="annotate long">line 2248 didn't jump to line 2252, because the condition on line 2248 was never false</span></span></p> + <p class="run"><span class="n"><a id="t2249" href="#t2249">2249</a></span><span class="t"> <span class="nam">raw_value</span> <span class="op">=</span> <span class="str">" "</span> <span class="op">+</span> <span class="nam">stripped</span> <span class="op">+</span> <span class="str">"\n"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2250" href="#t2250">2250</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2251" href="#t2251">2251</a></span><span class="t"> <span class="com"># Special-case for empty values</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2252" href="#t2252">2252</a></span><span class="t"> <span class="nam">raw_value</span> <span class="op">=</span> <span class="str">"\n"</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2253" href="#t2253">2253</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">set_field_from_raw_string</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2254" href="#t2254">2254</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2255" href="#t2255">2255</a></span><span class="t"> <span class="nam">raw_value</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2256" href="#t2256">2256</a></span><span class="t"> <span class="nam">preserve_original_field_comment</span><span class="op">=</span><span class="nam">preserve_original_field_comment</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2257" href="#t2257">2257</a></span><span class="t"> <span class="nam">field_comment</span><span class="op">=</span><span class="nam">field_comment</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2258" href="#t2258">2258</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2259" href="#t2259">2259</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2260" href="#t2260">2260</a></span><span class="t"> <span class="key">def</span> <span class="nam">set_field_from_raw_string</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2261" href="#t2261">2261</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2262" href="#t2262">2262</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> <span class="com"># type: ParagraphKey</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2263" href="#t2263">2263</a></span><span class="t"> <span class="nam">raw_string_value</span><span class="op">,</span> <span class="com"># type: str</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2264" href="#t2264">2264</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2265" href="#t2265">2265</a></span><span class="t"> <span class="nam">preserve_original_field_comment</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> <span class="com"># type: Optional[bool]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2266" href="#t2266">2266</a></span><span class="t"> <span class="nam">field_comment</span><span class="op">=</span><span class="key">None</span><span class="op">,</span> <span class="com"># type: Optional[Commentish]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2267" href="#t2267">2267</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2268" href="#t2268">2268</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2269" href="#t2269">2269</a></span><span class="t"> <span class="str">"""Sets a field in this paragraph to a given text value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2270" href="#t2270">2270</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2271" href="#t2271">2271</a></span><span class="t"><span class="str"> In many cases, it is better for callers to just use the paragraph as</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2272" href="#t2272">2272</a></span><span class="t"><span class="str"> if it was a dictionary. However, this method does enable to you choose</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2273" href="#t2273">2273</a></span><span class="t"><span class="str"> the field comment (if any) and lets to have a higher degree of control</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2274" href="#t2274">2274</a></span><span class="t"><span class="str"> over whitespace (on the first line), which can be a reason for using it.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2275" href="#t2275">2275</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2276" href="#t2276">2276</a></span><span class="t"><span class="str"> Example usage:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2277" href="#t2277">2277</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2278" href="#t2278">2278</a></span><span class="t"><span class="str"> >>> example_deb822_paragraph = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2279" href="#t2279">2279</a></span><span class="t"><span class="str"> ... Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2280" href="#t2280">2280</a></span><span class="t"><span class="str"> ... '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2281" href="#t2281">2281</a></span><span class="t"><span class="str"> >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines())</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2282" href="#t2282">2282</a></span><span class="t"><span class="str"> >>> p = next(iter(dfile))</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2283" href="#t2283">2283</a></span><span class="t"><span class="str"> >>> raw_value = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2284" href="#t2284">2284</a></span><span class="t"><span class="str"> ... Build-Depends: debhelper-compat (= 12),</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2285" href="#t2285">2285</a></span><span class="t"><span class="str"> ... some-other-bd,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2286" href="#t2286">2286</a></span><span class="t"><span class="str"> ... # Comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2287" href="#t2287">2287</a></span><span class="t"><span class="str"> ... another-bd,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2288" href="#t2288">2288</a></span><span class="t"><span class="str"> ... '''.lstrip() # Remove leading newline, but *not* the trailing newline</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2289" href="#t2289">2289</a></span><span class="t"><span class="str"> >>> fname, new_value = raw_value.split(':', 1)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2290" href="#t2290">2290</a></span><span class="t"><span class="str"> >>> p.set_field_from_raw_string(fname, new_value)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2291" href="#t2291">2291</a></span><span class="t"><span class="str"> >>> print(p.dump(), end='')</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2292" href="#t2292">2292</a></span><span class="t"><span class="str"> Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2293" href="#t2293">2293</a></span><span class="t"><span class="str"> Build-Depends: debhelper-compat (= 12),</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2294" href="#t2294">2294</a></span><span class="t"><span class="str"> some-other-bd,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2295" href="#t2295">2295</a></span><span class="t"><span class="str"> # Comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2296" href="#t2296">2296</a></span><span class="t"><span class="str"> another-bd,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2297" href="#t2297">2297</a></span><span class="t"><span class="str"> >>> # Format preserved</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2298" href="#t2298">2298</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2299" href="#t2299">2299</a></span><span class="t"><span class="str"> :param item: Name of the field to set. If the paragraph already</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2300" href="#t2300">2300</a></span><span class="t"><span class="str"> contains the field, then it will be replaced. Otherwise, it is</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2301" href="#t2301">2301</a></span><span class="t"><span class="str"> added to the end of the paragraph.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2302" href="#t2302">2302</a></span><span class="t"><span class="str"> Note this can be a "paragraph key", which enables you to control</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2303" href="#t2303">2303</a></span><span class="t"><span class="str"> *which* instance of a field is being replaced (in case of duplicate</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2304" href="#t2304">2304</a></span><span class="t"><span class="str"> fields).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2305" href="#t2305">2305</a></span><span class="t"><span class="str"> :param raw_string_value: The text to use as the value. The text must</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2306" href="#t2306">2306</a></span><span class="t"><span class="str"> be valid deb822 syntax and is used *exactly* as it is given.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2307" href="#t2307">2307</a></span><span class="t"><span class="str"> Accordingly, multi-line values must include mandatory leading space</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2308" href="#t2308">2308</a></span><span class="t"><span class="str"> on continuation lines, newlines after the value, etc. On the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2309" href="#t2309">2309</a></span><span class="t"><span class="str"> flip-side, any optional space or comments will be included.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2310" href="#t2310">2310</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2311" href="#t2311">2311</a></span><span class="t"><span class="str"> Note that the first line will *never* be read as a comment (if the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2312" href="#t2312">2312</a></span><span class="t"><span class="str"> first line of the value starts with a "#" then it will result</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2313" href="#t2313">2313</a></span><span class="t"><span class="str"> in "Field-Name:#..." which is parsed as a value starting with "#"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2314" href="#t2314">2314</a></span><span class="t"><span class="str"> rather than a comment).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2315" href="#t2315">2315</a></span><span class="t"><span class="str"> :param preserve_original_field_comment: If True, then if there is an</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2316" href="#t2316">2316</a></span><span class="t"><span class="str"> existing field and that has a comment, then the comment will remain</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2317" href="#t2317">2317</a></span><span class="t"><span class="str"> after this operation. This is the default is the `field_comment`</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2318" href="#t2318">2318</a></span><span class="t"><span class="str"> parameter is omitted.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2319" href="#t2319">2319</a></span><span class="t"><span class="str"> Note that if the parameter is True and the item is ambiguous, this</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2320" href="#t2320">2320</a></span><span class="t"><span class="str"> will raise an AmbiguousDeb822FieldKeyError. When the parameter is</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2321" href="#t2321">2321</a></span><span class="t"><span class="str"> omitted, the ambiguity is resolved automatically and if the resolved</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2322" href="#t2322">2322</a></span><span class="t"><span class="str"> field has a comment then that will be preserved (assuming</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2323" href="#t2323">2323</a></span><span class="t"><span class="str"> field_comment is None).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2324" href="#t2324">2324</a></span><span class="t"><span class="str"> :param field_comment: If not None, add or replace the comment for</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2325" href="#t2325">2325</a></span><span class="t"><span class="str"> the field. Each string in the list will become one comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2326" href="#t2326">2326</a></span><span class="t"><span class="str"> line (inserted directly before the field name). Will appear in the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2327" href="#t2327">2327</a></span><span class="t"><span class="str"> same order as they do in the list.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2328" href="#t2328">2328</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2329" href="#t2329">2329</a></span><span class="t"><span class="str"> If you want complete control over the formatting of the comments,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2330" href="#t2330">2330</a></span><span class="t"><span class="str"> then ensure that each line start with "#" and end with "\\n" before</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2331" href="#t2331">2331</a></span><span class="t"><span class="str"> the call. Otherwise, leading/trailing whitespace is normalized</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2332" href="#t2332">2332</a></span><span class="t"><span class="str"> and the missing "#"/"\\n" character is inserted.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2333" href="#t2333">2333</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2334" href="#t2334">2334</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2335" href="#t2335">2335</a></span><span class="t"> <span class="nam">new_content</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> <span class="com"># type: List[str]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2336" href="#t2336">2336</a></span><span class="t"> <span class="key">if</span> <span class="nam">preserve_original_field_comment</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2337" href="#t2337">2337</a></span><span class="t"> <span class="key">if</span> <span class="nam">field_comment</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2337 ↛ 2338</span><span class="annotate long">line 2337 didn't jump to line 2338, because the condition on line 2337 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2338" href="#t2338">2338</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2339" href="#t2339">2339</a></span><span class="t"> <span class="str">'The "preserve_original_field_comment" conflicts with'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2340" href="#t2340">2340</a></span><span class="t"> <span class="str">' "field_comment" parameter'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2341" href="#t2341">2341</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2342" href="#t2342">2342</a></span><span class="t"> <span class="key">elif</span> <span class="nam">field_comment</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2343" href="#t2343">2343</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">field_comment</span><span class="op">,</span> <span class="nam">Deb822CommentElement</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2343 ↛ 2346</span><span class="annotate long">line 2343 didn't jump to line 2346, because the condition on line 2343 was never false</span></span></p> + <p class="run"><span class="n"><a id="t2344" href="#t2344">2344</a></span><span class="t"> <span class="nam">new_content</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">_format_comment</span><span class="op">(</span><span class="nam">x</span><span class="op">)</span> <span class="key">for</span> <span class="nam">x</span> <span class="key">in</span> <span class="nam">field_comment</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2345" href="#t2345">2345</a></span><span class="t"> <span class="nam">field_comment</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2346" href="#t2346">2346</a></span><span class="t"> <span class="nam">preserve_original_field_comment</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2347" href="#t2347">2347</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2348" href="#t2348">2348</a></span><span class="t"> <span class="nam">field_name</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2349" href="#t2349">2349</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2350" href="#t2350">2350</a></span><span class="t"> <span class="nam">cased_field_name</span> <span class="op">=</span> <span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2351" href="#t2351">2351</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2352" href="#t2352">2352</a></span><span class="t"> <span class="nam">original</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">use_get</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2353" href="#t2353">2353</a></span><span class="t"> <span class="key">except</span> <span class="nam">AmbiguousDeb822FieldKeyError</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2354" href="#t2354">2354</a></span><span class="t"> <span class="key">if</span> <span class="nam">preserve_original_field_comment</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2355" href="#t2355">2355</a></span><span class="t"> <span class="com"># If we were asked to preserve the original comment, then we</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2356" href="#t2356">2356</a></span><span class="t"> <span class="com"># require a strict lookup</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2357" href="#t2357">2357</a></span><span class="t"> <span class="key">raise</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2358" href="#t2358">2358</a></span><span class="t"> <span class="nam">original</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="op">(</span><span class="nam">field_name</span><span class="op">,</span> <span class="num">0</span><span class="op">)</span><span class="op">,</span> <span class="nam">use_get</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2359" href="#t2359">2359</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2360" href="#t2360">2360</a></span><span class="t"> <span class="key">if</span> <span class="nam">preserve_original_field_comment</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2361" href="#t2361">2361</a></span><span class="t"> <span class="com"># We simplify preserve_original_field_comment after the lookup of the field.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2362" href="#t2362">2362</a></span><span class="t"> <span class="com"># Otherwise, we can get ambiguous key errors when updating an ambiguous field</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2363" href="#t2363">2363</a></span><span class="t"> <span class="com"># when the caller did not explicitly ask for that behaviour.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2364" href="#t2364">2364</a></span><span class="t"> <span class="nam">preserve_original_field_comment</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2365" href="#t2365">2365</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2366" href="#t2366">2366</a></span><span class="t"> <span class="key">if</span> <span class="nam">original</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2367" href="#t2367">2367</a></span><span class="t"> <span class="com"># If we already have the field, then preserve the original case</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2368" href="#t2368">2368</a></span><span class="t"> <span class="nam">cased_field_name</span> <span class="op">=</span> <span class="nam">original</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2369" href="#t2369">2369</a></span><span class="t"> <span class="nam">raw</span> <span class="op">=</span> <span class="str">":"</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="op">(</span><span class="nam">cased_field_name</span><span class="op">,</span> <span class="nam">raw_string_value</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2370" href="#t2370">2370</a></span><span class="t"> <span class="nam">raw_lines</span> <span class="op">=</span> <span class="nam">raw</span><span class="op">.</span><span class="nam">splitlines</span><span class="op">(</span><span class="nam">keepends</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2371" href="#t2371">2371</a></span><span class="t"> <span class="key">for</span> <span class="nam">i</span><span class="op">,</span> <span class="nam">line</span> <span class="key">in</span> <span class="nam">enumerate</span><span class="op">(</span><span class="nam">raw_lines</span><span class="op">,</span> <span class="nam">start</span><span class="op">=</span><span class="num">1</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2372" href="#t2372">2372</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">line</span><span class="op">.</span><span class="nam">endswith</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2372 ↛ 2373</span><span class="annotate long">line 2372 didn't jump to line 2373, because the condition on line 2372 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2373" href="#t2373">2373</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2374" href="#t2374">2374</a></span><span class="t"> <span class="str">"Line {i} in new value was missing trailing newline"</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">i</span><span class="op">=</span><span class="nam">i</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2375" href="#t2375">2375</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2376" href="#t2376">2376</a></span><span class="t"> <span class="key">if</span> <span class="nam">i</span> <span class="op">!=</span> <span class="num">1</span> <span class="key">and</span> <span class="nam">line</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="key">not</span> <span class="key">in</span> <span class="op">(</span><span class="str">" "</span><span class="op">,</span> <span class="str">"\t"</span><span class="op">,</span> <span class="str">"#"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2376 ↛ 2377</span><span class="annotate long">line 2376 didn't jump to line 2377</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2377" href="#t2377">2377</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2378" href="#t2378">2378</a></span><span class="t"> <span class="str">"Line {i} in new value was invalid. It must either start"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2379" href="#t2379">2379</a></span><span class="t"> <span class="str">' with " " space (continuation line) or "#" (comment line).'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2380" href="#t2380">2380</a></span><span class="t"> <span class="str">' The line started with "{line}"'</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2381" href="#t2381">2381</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2382" href="#t2382">2382</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">i</span><span class="op">=</span><span class="nam">i</span><span class="op">,</span> <span class="nam">line</span><span class="op">=</span><span class="nam">line</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2383" href="#t2383">2383</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">raw_lines</span><span class="op">)</span> <span class="op">></span> <span class="num">1</span> <span class="key">and</span> <span class="nam">raw_lines</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">.</span><span class="nam">startswith</span><span class="op">(</span><span class="str">"#"</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2383 ↛ 2384</span><span class="annotate long">line 2383 didn't jump to line 2384, because the condition on line 2383 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2384" href="#t2384">2384</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"The last line in a value field cannot be a comment"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2385" href="#t2385">2385</a></span><span class="t"> <span class="nam">new_content</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">raw_lines</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2386" href="#t2386">2386</a></span><span class="t"> <span class="com"># As absurd as it might seem, it is easier to just use the parser to</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2387" href="#t2387">2387</a></span><span class="t"> <span class="com"># construct the AST correctly</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2388" href="#t2388">2388</a></span><span class="t"> <span class="nam">deb822_file</span> <span class="op">=</span> <span class="nam">parse_deb822_file</span><span class="op">(</span><span class="nam">iter</span><span class="op">(</span><span class="nam">new_content</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2389" href="#t2389">2389</a></span><span class="t"> <span class="nam">error_token</span> <span class="op">=</span> <span class="nam">deb822_file</span><span class="op">.</span><span class="nam">find_first_error_element</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2390" href="#t2390">2390</a></span><span class="t"> <span class="key">if</span> <span class="nam">error_token</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2390 ↛ 2391</span><span class="annotate long">line 2390 didn't jump to line 2391, because the condition on line 2390 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2391" href="#t2391">2391</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Syntax error in new field value for "</span> <span class="op">+</span> <span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2392" href="#t2392">2392</a></span><span class="t"> <span class="nam">paragraph</span> <span class="op">=</span> <span class="nam">next</span><span class="op">(</span><span class="nam">iter</span><span class="op">(</span><span class="nam">deb822_file</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2393" href="#t2393">2393</a></span><span class="t"> <span class="key">assert</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">paragraph</span><span class="op">,</span> <span class="nam">Deb822NoDuplicateFieldsParagraphElement</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2394" href="#t2394">2394</a></span><span class="t"> <span class="nam">value</span> <span class="op">=</span> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2395" href="#t2395">2395</a></span><span class="t"> <span class="key">assert</span> <span class="nam">value</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2396" href="#t2396">2396</a></span><span class="t"> <span class="key">if</span> <span class="nam">preserve_original_field_comment</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2397" href="#t2397">2397</a></span><span class="t"> <span class="key">if</span> <span class="nam">original</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2398" href="#t2398">2398</a></span><span class="t"> <span class="nam">value</span><span class="op">.</span><span class="nam">comment_element</span> <span class="op">=</span> <span class="nam">original</span><span class="op">.</span><span class="nam">comment_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2399" href="#t2399">2399</a></span><span class="t"> <span class="nam">original</span><span class="op">.</span><span class="nam">comment_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2400" href="#t2400">2400</a></span><span class="t"> <span class="key">elif</span> <span class="nam">field_comment</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2400 ↛ 2401</span><span class="annotate long">line 2400 didn't jump to line 2401, because the condition on line 2400 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2401" href="#t2401">2401</a></span><span class="t"> <span class="nam">value</span><span class="op">.</span><span class="nam">comment_element</span> <span class="op">=</span> <span class="nam">field_comment</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2402" href="#t2402">2402</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">set_kvpair_element</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2403" href="#t2403">2403</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2404" href="#t2404">2404</a></span><span class="t"> <span class="op">@</span><span class="nam">overload</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2405" href="#t2405">2405</a></span><span class="t"> <span class="key">def</span> <span class="nam">dump</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2406" href="#t2406">2406</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">fd</span> <span class="com"># type: IO[bytes]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2407" href="#t2407">2407</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2408" href="#t2408">2408</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2409" href="#t2409">2409</a></span><span class="t"> <span class="key">pass</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2410" href="#t2410">2410</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2411" href="#t2411">2411</a></span><span class="t"> <span class="op">@</span><span class="nam">overload</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2412" href="#t2412">2412</a></span><span class="t"> <span class="key">def</span> <span class="nam">dump</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2413" href="#t2413">2413</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2414" href="#t2414">2414</a></span><span class="t"> <span class="key">pass</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2415" href="#t2415">2415</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2416" href="#t2416">2416</a></span><span class="t"> <span class="key">def</span> <span class="nam">dump</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2417" href="#t2417">2417</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">fd</span><span class="op">=</span><span class="key">None</span> <span class="com"># type: Optional[IO[bytes]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2418" href="#t2418">2418</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2419" href="#t2419">2419</a></span><span class="t"> <span class="com"># type: (...) -> Optional[str]</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2420" href="#t2420">2420</a></span><span class="t"> <span class="key">if</span> <span class="nam">fd</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2420 ↛ 2422</span><span class="annotate long">line 2420 didn't jump to line 2422, because the condition on line 2420 was never false</span></span></p> + <p class="run"><span class="n"><a id="t2421" href="#t2421">2421</a></span><span class="t"> <span class="key">return</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">t</span><span class="op">.</span><span class="nam">text</span> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2422" href="#t2422">2422</a></span><span class="t"> <span class="key">for</span> <span class="nam">token</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2423" href="#t2423">2423</a></span><span class="t"> <span class="nam">fd</span><span class="op">.</span><span class="nam">write</span><span class="op">(</span><span class="nam">token</span><span class="op">.</span><span class="nam">text</span><span class="op">.</span><span class="nam">encode</span><span class="op">(</span><span class="str">"utf-8"</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2424" href="#t2424">2424</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2425" href="#t2425">2425</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2426" href="#t2426">2426</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2427" href="#t2427">2427</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822NoDuplicateFieldsParagraphElement</span><span class="op">(</span><span class="nam">Deb822ParagraphElement</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2428" href="#t2428">2428</a></span><span class="t"> <span class="str">"""Paragraph implementation optimized for valid deb822 files</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2429" href="#t2429">2429</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2430" href="#t2430">2430</a></span><span class="t"><span class="str"> When there are no duplicated fields, we can use simpler and faster</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2431" href="#t2431">2431</a></span><span class="t"><span class="str"> datastructures for common operations.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2432" href="#t2432">2432</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2433" href="#t2433">2433</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2434" href="#t2434">2434</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2435" href="#t2435">2435</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2436" href="#t2436">2436</a></span><span class="t"> <span class="nam">kvpair_elements</span><span class="op">,</span> <span class="com"># type: List[Deb822KeyValuePairElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2437" href="#t2437">2437</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">,</span> <span class="com"># type: OrderedSet</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2438" href="#t2438">2438</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2439" href="#t2439">2439</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2440" href="#t2440">2440</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2441" href="#t2441">2441</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span> <span class="op">=</span> <span class="op">{</span><span class="nam">kv</span><span class="op">.</span><span class="nam">field_name</span><span class="op">:</span> <span class="nam">kv</span> <span class="key">for</span> <span class="nam">kv</span> <span class="key">in</span> <span class="nam">kvpair_elements</span><span class="op">}</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2442" href="#t2442">2442</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> <span class="op">=</span> <span class="nam">kvpair_order</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2443" href="#t2443">2443</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2444" href="#t2444">2444</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2445" href="#t2445">2445</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2446" href="#t2446">2446</a></span><span class="t"> <span class="key">def</span> <span class="nam">kvpair_count</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2447" href="#t2447">2447</a></span><span class="t"> <span class="com"># type: () -> int</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2448" href="#t2448">2448</a></span><span class="t"> <span class="key">return</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2449" href="#t2449">2449</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2450" href="#t2450">2450</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_last</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2451" href="#t2451">2451</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2452" href="#t2452">2452</a></span><span class="t"> <span class="str">"""Re-order the given field so it is "last" in the paragraph"""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2453" href="#t2453">2453</a></span><span class="t"> <span class="nam">unpacked_field</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">field</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2454" href="#t2454">2454</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">order_last</span><span class="op">(</span><span class="nam">unpacked_field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2455" href="#t2455">2455</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2456" href="#t2456">2456</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_first</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2457" href="#t2457">2457</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2458" href="#t2458">2458</a></span><span class="t"> <span class="str">"""Re-order the given field so it is "first" in the paragraph"""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2459" href="#t2459">2459</a></span><span class="t"> <span class="nam">unpacked_field</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">field</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2460" href="#t2460">2460</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">order_first</span><span class="op">(</span><span class="nam">unpacked_field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2461" href="#t2461">2461</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2462" href="#t2462">2462</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_before</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">,</span> <span class="nam">reference_field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2463" href="#t2463">2463</a></span><span class="t"> <span class="com"># type: (ParagraphKey, ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2464" href="#t2464">2464</a></span><span class="t"> <span class="str">"""Re-order the given field so appears directly after the reference field in the paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2465" href="#t2465">2465</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2466" href="#t2466">2466</a></span><span class="t"><span class="str"> The reference field must be present."""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2467" href="#t2467">2467</a></span><span class="t"> <span class="nam">unpacked_field</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">field</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2468" href="#t2468">2468</a></span><span class="t"> <span class="nam">unpacked_ref_field</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">reference_field</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2469" href="#t2469">2469</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">order_before</span><span class="op">(</span><span class="nam">unpacked_field</span><span class="op">,</span> <span class="nam">unpacked_ref_field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2470" href="#t2470">2470</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2471" href="#t2471">2471</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_after</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">,</span> <span class="nam">reference_field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2472" href="#t2472">2472</a></span><span class="t"> <span class="com"># type: (ParagraphKey, ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2473" href="#t2473">2473</a></span><span class="t"> <span class="str">"""Re-order the given field so appears directly before the reference field in the paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2474" href="#t2474">2474</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2475" href="#t2475">2475</a></span><span class="t"><span class="str"> The reference field must be present.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2476" href="#t2476">2476</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2477" href="#t2477">2477</a></span><span class="t"> <span class="nam">unpacked_field</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">field</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2478" href="#t2478">2478</a></span><span class="t"> <span class="nam">unpacked_ref_field</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">reference_field</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2479" href="#t2479">2479</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">order_after</span><span class="op">(</span><span class="nam">unpacked_field</span><span class="op">,</span> <span class="nam">unpacked_ref_field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2480" href="#t2480">2480</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2481" href="#t2481">2481</a></span><span class="t"> <span class="com"># Overload to narrow the type to just str.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2482" href="#t2482">2482</a></span><span class="t"> <span class="key">def</span> <span class="nam">__iter__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2483" href="#t2483">2483</a></span><span class="t"> <span class="com"># type: () -> Iterator[str]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2484" href="#t2484">2484</a></span><span class="t"> <span class="key">return</span> <span class="nam">iter</span><span class="op">(</span><span class="nam">str</span><span class="op">(</span><span class="nam">k</span><span class="op">)</span> <span class="key">for</span> <span class="nam">k</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2485" href="#t2485">2485</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2486" href="#t2486">2486</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_keys</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2487" href="#t2487">2487</a></span><span class="t"> <span class="com"># type: () -> Iterable[str]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2488" href="#t2488">2488</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="op">(</span><span class="nam">str</span><span class="op">(</span><span class="nam">k</span><span class="op">)</span> <span class="key">for</span> <span class="nam">k</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2489" href="#t2489">2489</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2490" href="#t2490">2490</a></span><span class="t"> <span class="key">def</span> <span class="nam">remove_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2491" href="#t2491">2491</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2492" href="#t2492">2492</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2493" href="#t2493">2493</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">key</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2494" href="#t2494">2494</a></span><span class="t"> <span class="key">del</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2495" href="#t2495">2495</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">remove</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2496" href="#t2496">2496</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2497" href="#t2497">2497</a></span><span class="t"> <span class="key">def</span> <span class="nam">contains_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2498" href="#t2498">2498</a></span><span class="t"> <span class="com"># type: (object) -> bool</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2499" href="#t2499">2499</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="op">(</span><span class="nam">str</span><span class="op">,</span> <span class="nam">tuple</span><span class="op">,</span> <span class="nam">Deb822FieldNameToken</span><span class="op">)</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2499 ↛ 2500</span><span class="annotate long">line 2499 didn't jump to line 2500, because the condition on line 2499 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2500" href="#t2500">2500</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2501" href="#t2501">2501</a></span><span class="t"> <span class="nam">item</span> <span class="op">=</span> <span class="nam">cast</span><span class="op">(</span><span class="str">"ParagraphKey"</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2502" href="#t2502">2502</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2503" href="#t2503">2503</a></span><span class="t"> <span class="key">return</span> <span class="nam">key</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2504" href="#t2504">2504</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2505" href="#t2505">2505</a></span><span class="t"> <span class="key">def</span> <span class="nam">get_kvpair_element</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2506" href="#t2506">2506</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2507" href="#t2507">2507</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> <span class="com"># type: ParagraphKey</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2508" href="#t2508">2508</a></span><span class="t"> <span class="nam">use_get</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2509" href="#t2509">2509</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2510" href="#t2510">2510</a></span><span class="t"> <span class="com"># type: (...) -> Optional[Deb822KeyValuePairElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2511" href="#t2511">2511</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2512" href="#t2512">2512</a></span><span class="t"> <span class="key">if</span> <span class="nam">use_get</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2513" href="#t2513">2513</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2514" href="#t2514">2514</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">item</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2515" href="#t2515">2515</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2516" href="#t2516">2516</a></span><span class="t"> <span class="key">def</span> <span class="nam">set_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2517" href="#t2517">2517</a></span><span class="t"> <span class="com"># type: (ParagraphKey, Deb822KeyValuePairElement) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2518" href="#t2518">2518</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">key</span><span class="op">,</span> <span class="nam">raise_if_indexed</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2519" href="#t2519">2519</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">key</span><span class="op">,</span> <span class="nam">Deb822FieldNameToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2519 ↛ 2520</span><span class="annotate long">line 2519 didn't jump to line 2520, because the condition on line 2519 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2520" href="#t2520">2520</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span> <span class="key">is</span> <span class="key">not</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_token</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2521" href="#t2521">2521</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2522" href="#t2522">2522</a></span><span class="t"> <span class="str">"Key is a Deb822FieldNameToken, but not *the* Deb822FieldNameToken"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2523" href="#t2523">2523</a></span><span class="t"> <span class="str">" for the value"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2524" href="#t2524">2524</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2525" href="#t2525">2525</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2526" href="#t2526">2526</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t2527" href="#t2527">2527</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span> <span class="op">!=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span><span class="op">:</span> </span><span class="r"><span class="annotate short">2527 ↛ 2528</span><span class="annotate long">line 2527 didn't jump to line 2528, because the condition on line 2527 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t2528" href="#t2528">2528</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2529" href="#t2529">2529</a></span><span class="t"> <span class="str">"Cannot insert value under a different field value than field name"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2530" href="#t2530">2530</a></span><span class="t"> <span class="str">" from its Deb822FieldNameToken implies"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2531" href="#t2531">2531</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2532" href="#t2532">2532</a></span><span class="t"> <span class="com"># Use the string from the Deb822FieldNameToken as we need to keep that in memory either</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2533" href="#t2533">2533</a></span><span class="t"> <span class="com"># way</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2534" href="#t2534">2534</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2535" href="#t2535">2535</a></span><span class="t"> <span class="nam">original_value</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2536" href="#t2536">2536</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2537" href="#t2537">2537</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> <span class="op">=</span> <span class="nam">value</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2538" href="#t2538">2538</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2539" href="#t2539">2539</a></span><span class="t"> <span class="key">if</span> <span class="nam">original_value</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2540" href="#t2540">2540</a></span><span class="t"> <span class="nam">original_value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2541" href="#t2541">2541</a></span><span class="t"> <span class="nam">value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2542" href="#t2542">2542</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2543" href="#t2543">2543</a></span><span class="t"> <span class="key">def</span> <span class="nam">sort_fields</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">None</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2544" href="#t2544">2544</a></span><span class="t"> <span class="com"># type: (Optional[Callable[[str], Any]]) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2545" href="#t2545">2545</a></span><span class="t"> <span class="str">"""Re-order all fields</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2546" href="#t2546">2546</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2547" href="#t2547">2547</a></span><span class="t"><span class="str"> :param key: Provide a key function (same semantics as for sorted). Keep in mind that</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2548" href="#t2548">2548</a></span><span class="t"><span class="str"> the module preserve the cases for field names - in generally, callers are recommended</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2549" href="#t2549">2549</a></span><span class="t"><span class="str"> to use "lower()" to normalize the case.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2550" href="#t2550">2550</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2551" href="#t2551">2551</a></span><span class="t"> <span class="key">for</span> <span class="nam">last_field_name</span> <span class="key">in</span> <span class="nam">reversed</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2552" href="#t2552">2552</a></span><span class="t"> <span class="nam">last_kvpair</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">cast</span><span class="op">(</span><span class="str">"_strI"</span><span class="op">,</span> <span class="nam">last_field_name</span><span class="op">)</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2553" href="#t2553">2553</a></span><span class="t"> <span class="key">if</span> <span class="nam">last_kvpair</span><span class="op">.</span><span class="nam">value_element</span><span class="op">.</span><span class="nam">add_final_newline_if_missing</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2554" href="#t2554">2554</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2555" href="#t2555">2555</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2556" href="#t2556">2556</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2557" href="#t2557">2557</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2558" href="#t2558">2558</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">default_field_sort_key</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2559" href="#t2559">2559</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2560" href="#t2560">2560</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> <span class="op">=</span> <span class="nam">OrderedSet</span><span class="op">(</span><span class="nam">sorted</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="nam">key</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2561" href="#t2561">2561</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2562" href="#t2562">2562</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2563" href="#t2563">2563</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2564" href="#t2564">2564</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2565" href="#t2565">2565</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">x</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2566" href="#t2566">2566</a></span><span class="t"> <span class="key">for</span> <span class="nam">x</span> <span class="key">in</span> <span class="nam">cast</span><span class="op">(</span><span class="str">"Iterable[_strI]"</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2567" href="#t2567">2567</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2568" href="#t2568">2568</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2569" href="#t2569">2569</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2570" href="#t2570">2570</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822DuplicateFieldsParagraphElement</span><span class="op">(</span><span class="nam">Deb822ParagraphElement</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2571" href="#t2571">2571</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2572" href="#t2572">2572</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">kvpair_elements</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2573" href="#t2573">2573</a></span><span class="t"> <span class="com"># type: (List[Deb822KeyValuePairElement]) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2574" href="#t2574">2574</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2575" href="#t2575">2575</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> <span class="op">=</span> <span class="nam">LinkedList</span><span class="op">(</span><span class="op">)</span> <span class="com"># type: LinkedList[Deb822KeyValuePairElement]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2576" href="#t2576">2576</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span> <span class="op">=</span> <span class="op">{</span><span class="op">}</span> <span class="com"># type: Dict[_strI, List[KVPNode]]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2577" href="#t2577">2577</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_kvpair_fields</span><span class="op">(</span><span class="nam">kvpair_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2578" href="#t2578">2578</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2579" href="#t2579">2579</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2580" href="#t2580">2580</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2581" href="#t2581">2581</a></span><span class="t"> <span class="key">def</span> <span class="nam">has_duplicate_fields</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2582" href="#t2582">2582</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2583" href="#t2583">2583</a></span><span class="t"> <span class="com"># Most likely, the answer is "True" but if the caller "fixes" the problem</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2584" href="#t2584">2584</a></span><span class="t"> <span class="com"># then this can return "False"</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2585" href="#t2585">2585</a></span><span class="t"> <span class="key">return</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span> <span class="op">></span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2586" href="#t2586">2586</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2587" href="#t2587">2587</a></span><span class="t"> <span class="key">def</span> <span class="nam">_init_kvpair_fields</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">kvpairs</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2588" href="#t2588">2588</a></span><span class="t"> <span class="com"># type: (Iterable[Deb822KeyValuePairElement]) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2589" href="#t2589">2589</a></span><span class="t"> <span class="key">assert</span> <span class="key">not</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2590" href="#t2590">2590</a></span><span class="t"> <span class="key">assert</span> <span class="key">not</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2591" href="#t2591">2591</a></span><span class="t"> <span class="key">for</span> <span class="nam">kv</span> <span class="key">in</span> <span class="nam">kvpairs</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2592" href="#t2592">2592</a></span><span class="t"> <span class="nam">field_name</span> <span class="op">=</span> <span class="nam">kv</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2593" href="#t2593">2593</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">kv</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2594" href="#t2594">2594</a></span><span class="t"> <span class="key">if</span> <span class="nam">field_name</span> <span class="key">not</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2595" href="#t2595">2595</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">field_name</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="nam">node</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2596" href="#t2596">2596</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2597" href="#t2597">2597</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">field_name</span><span class="op">]</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2598" href="#t2598">2598</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2599" href="#t2599">2599</a></span><span class="t"> <span class="key">def</span> <span class="nam">_nodes_being_relocated</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2600" href="#t2600">2600</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> Tuple[List[KVPNode], List[KVPNode]]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2601" href="#t2601">2601</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">,</span> <span class="nam">name_token</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2602" href="#t2602">2602</a></span><span class="t"> <span class="nam">nodes</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2603" href="#t2603">2603</a></span><span class="t"> <span class="nam">nodes_being_relocated</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2604" href="#t2604">2604</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2605" href="#t2605">2605</a></span><span class="t"> <span class="key">if</span> <span class="nam">name_token</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">or</span> <span class="nam">index</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2606" href="#t2606">2606</a></span><span class="t"> <span class="nam">single_node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_resolve_to_single_node</span><span class="op">(</span><span class="nam">nodes</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">,</span> <span class="nam">name_token</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2607" href="#t2607">2607</a></span><span class="t"> <span class="key">assert</span> <span class="nam">single_node</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2608" href="#t2608">2608</a></span><span class="t"> <span class="nam">nodes_being_relocated</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">single_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2609" href="#t2609">2609</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2610" href="#t2610">2610</a></span><span class="t"> <span class="nam">nodes_being_relocated</span> <span class="op">=</span> <span class="nam">nodes</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2611" href="#t2611">2611</a></span><span class="t"> <span class="key">return</span> <span class="nam">nodes</span><span class="op">,</span> <span class="nam">nodes_being_relocated</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2612" href="#t2612">2612</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2613" href="#t2613">2613</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_last</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2614" href="#t2614">2614</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2615" href="#t2615">2615</a></span><span class="t"> <span class="str">"""Re-order the given field so it is "last" in the paragraph"""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2616" href="#t2616">2616</a></span><span class="t"> <span class="nam">nodes</span><span class="op">,</span> <span class="nam">nodes_being_relocated</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_nodes_being_relocated</span><span class="op">(</span><span class="nam">field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2617" href="#t2617">2617</a></span><span class="t"> <span class="key">assert</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> <span class="key">or</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2618" href="#t2618">2618</a></span><span class="t"> <span class="nam">nodes_being_relocated</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2619" href="#t2619">2619</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2620" href="#t2620">2620</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2621" href="#t2621">2621</a></span><span class="t"> <span class="nam">kvpair_order</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2622" href="#t2622">2622</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">nodes_being_relocated</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2623" href="#t2623">2623</a></span><span class="t"> <span class="key">if</span> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">tail_node</span> <span class="key">is</span> <span class="nam">node</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2624" href="#t2624">2624</a></span><span class="t"> <span class="com"># Special case for relocating a single node that happens to be the last.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2625" href="#t2625">2625</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2626" href="#t2626">2626</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2627" href="#t2627">2627</a></span><span class="t"> <span class="com"># assertion for mypy</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2628" href="#t2628">2628</a></span><span class="t"> <span class="key">assert</span> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">tail_node</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2629" href="#t2629">2629</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">insert_node_after</span><span class="op">(</span><span class="nam">node</span><span class="op">,</span> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">tail_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2630" href="#t2630">2630</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2631" href="#t2631">2631</a></span><span class="t"> <span class="key">if</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2632" href="#t2632">2632</a></span><span class="t"> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2633" href="#t2633">2633</a></span><span class="t"> <span class="key">and</span> <span class="nam">nodes_being_relocated</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="key">is</span> <span class="key">not</span> <span class="nam">nodes</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2634" href="#t2634">2634</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2635" href="#t2635">2635</a></span><span class="t"> <span class="nam">single_node</span> <span class="op">=</span> <span class="nam">nodes_being_relocated</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2636" href="#t2636">2636</a></span><span class="t"> <span class="nam">nodes</span><span class="op">.</span><span class="nam">remove</span><span class="op">(</span><span class="nam">single_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2637" href="#t2637">2637</a></span><span class="t"> <span class="nam">nodes</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">single_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2638" href="#t2638">2638</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2639" href="#t2639">2639</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_first</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2640" href="#t2640">2640</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2641" href="#t2641">2641</a></span><span class="t"> <span class="str">"""Re-order the given field so it is "first" in the paragraph"""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2642" href="#t2642">2642</a></span><span class="t"> <span class="nam">nodes</span><span class="op">,</span> <span class="nam">nodes_being_relocated</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_nodes_being_relocated</span><span class="op">(</span><span class="nam">field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2643" href="#t2643">2643</a></span><span class="t"> <span class="key">assert</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> <span class="key">or</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2644" href="#t2644">2644</a></span><span class="t"> <span class="nam">nodes_being_relocated</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2645" href="#t2645">2645</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2646" href="#t2646">2646</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2647" href="#t2647">2647</a></span><span class="t"> <span class="nam">kvpair_order</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2648" href="#t2648">2648</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">nodes_being_relocated</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2649" href="#t2649">2649</a></span><span class="t"> <span class="key">if</span> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">head_node</span> <span class="key">is</span> <span class="nam">node</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2650" href="#t2650">2650</a></span><span class="t"> <span class="com"># Special case for relocating a single node that happens to be the first.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2651" href="#t2651">2651</a></span><span class="t"> <span class="key">continue</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2652" href="#t2652">2652</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2653" href="#t2653">2653</a></span><span class="t"> <span class="com"># assertion for mypy</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2654" href="#t2654">2654</a></span><span class="t"> <span class="key">assert</span> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">head_node</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2655" href="#t2655">2655</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">insert_node_before</span><span class="op">(</span><span class="nam">node</span><span class="op">,</span> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">head_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2656" href="#t2656">2656</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2657" href="#t2657">2657</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> <span class="key">and</span> <span class="nam">nodes_being_relocated</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> <span class="key">is</span> <span class="key">not</span> <span class="nam">nodes</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2658" href="#t2658">2658</a></span><span class="t"> <span class="nam">single_node</span> <span class="op">=</span> <span class="nam">nodes_being_relocated</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2659" href="#t2659">2659</a></span><span class="t"> <span class="nam">nodes</span><span class="op">.</span><span class="nam">remove</span><span class="op">(</span><span class="nam">single_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2660" href="#t2660">2660</a></span><span class="t"> <span class="nam">nodes</span><span class="op">.</span><span class="nam">insert</span><span class="op">(</span><span class="num">0</span><span class="op">,</span> <span class="nam">single_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2661" href="#t2661">2661</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2662" href="#t2662">2662</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_before</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">,</span> <span class="nam">reference_field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2663" href="#t2663">2663</a></span><span class="t"> <span class="com"># type: (ParagraphKey, ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2664" href="#t2664">2664</a></span><span class="t"> <span class="str">"""Re-order the given field so appears directly after the reference field in the paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2665" href="#t2665">2665</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2666" href="#t2666">2666</a></span><span class="t"><span class="str"> The reference field must be present."""</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2667" href="#t2667">2667</a></span><span class="t"> <span class="nam">nodes</span><span class="op">,</span> <span class="nam">nodes_being_relocated</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_nodes_being_relocated</span><span class="op">(</span><span class="nam">field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2668" href="#t2668">2668</a></span><span class="t"> <span class="key">assert</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> <span class="key">or</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2669" href="#t2669">2669</a></span><span class="t"> <span class="nam">nodes_being_relocated</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2670" href="#t2670">2670</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2671" href="#t2671">2671</a></span><span class="t"> <span class="com"># For "before" we always use the "first" variant as reference in case of doubt</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2672" href="#t2672">2672</a></span><span class="t"> <span class="nam">_</span><span class="op">,</span> <span class="nam">reference_nodes</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_nodes_being_relocated</span><span class="op">(</span><span class="nam">reference_field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2673" href="#t2673">2673</a></span><span class="t"> <span class="nam">reference_node</span> <span class="op">=</span> <span class="nam">reference_nodes</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2674" href="#t2674">2674</a></span><span class="t"> <span class="key">if</span> <span class="nam">reference_node</span> <span class="key">in</span> <span class="nam">nodes_being_relocated</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2675" href="#t2675">2675</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Cannot re-order a field relative to itself"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2676" href="#t2676">2676</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2677" href="#t2677">2677</a></span><span class="t"> <span class="nam">kvpair_order</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2678" href="#t2678">2678</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">nodes_being_relocated</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2679" href="#t2679">2679</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2680" href="#t2680">2680</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">insert_node_before</span><span class="op">(</span><span class="nam">node</span><span class="op">,</span> <span class="nam">reference_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2681" href="#t2681">2681</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2682" href="#t2682">2682</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> <span class="key">and</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">></span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2683" href="#t2683">2683</a></span><span class="t"> <span class="com"># Regenerate the (new) relative field order.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2684" href="#t2684">2684</a></span><span class="t"> <span class="nam">field_name</span> <span class="op">=</span> <span class="nam">nodes_being_relocated</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2685" href="#t2685">2685</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_regenerate_relative_kvapir_order</span><span class="op">(</span><span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2686" href="#t2686">2686</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2687" href="#t2687">2687</a></span><span class="t"> <span class="key">def</span> <span class="nam">order_after</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field</span><span class="op">,</span> <span class="nam">reference_field</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2688" href="#t2688">2688</a></span><span class="t"> <span class="com"># type: (ParagraphKey, ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2689" href="#t2689">2689</a></span><span class="t"> <span class="str">"""Re-order the given field so appears directly before the reference field in the paragraph</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2690" href="#t2690">2690</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2691" href="#t2691">2691</a></span><span class="t"><span class="str"> The reference field must be present.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2692" href="#t2692">2692</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2693" href="#t2693">2693</a></span><span class="t"> <span class="nam">nodes</span><span class="op">,</span> <span class="nam">nodes_being_relocated</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_nodes_being_relocated</span><span class="op">(</span><span class="nam">field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2694" href="#t2694">2694</a></span><span class="t"> <span class="key">assert</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> <span class="key">or</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2695" href="#t2695">2695</a></span><span class="t"> <span class="nam">nodes_being_relocated</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2696" href="#t2696">2696</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2697" href="#t2697">2697</a></span><span class="t"> <span class="nam">_</span><span class="op">,</span> <span class="nam">reference_nodes</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_nodes_being_relocated</span><span class="op">(</span><span class="nam">reference_field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2698" href="#t2698">2698</a></span><span class="t"> <span class="com"># For "after" we always use the "last" variant as reference in case of doubt</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2699" href="#t2699">2699</a></span><span class="t"> <span class="nam">reference_node</span> <span class="op">=</span> <span class="nam">reference_nodes</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2700" href="#t2700">2700</a></span><span class="t"> <span class="key">if</span> <span class="nam">reference_node</span> <span class="key">in</span> <span class="nam">nodes_being_relocated</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2701" href="#t2701">2701</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Cannot re-order a field relative to itself"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2702" href="#t2702">2702</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2703" href="#t2703">2703</a></span><span class="t"> <span class="nam">kvpair_order</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2704" href="#t2704">2704</a></span><span class="t"> <span class="com"># Use "reversed" to preserve the relative order of the nodes assuming a bulk reorder</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2705" href="#t2705">2705</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">reversed</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2706" href="#t2706">2706</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2707" href="#t2707">2707</a></span><span class="t"> <span class="nam">kvpair_order</span><span class="op">.</span><span class="nam">insert_node_after</span><span class="op">(</span><span class="nam">node</span><span class="op">,</span> <span class="nam">reference_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2708" href="#t2708">2708</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2709" href="#t2709">2709</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes_being_relocated</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span> <span class="key">and</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">></span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2710" href="#t2710">2710</a></span><span class="t"> <span class="com"># Regenerate the (new) relative field order.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2711" href="#t2711">2711</a></span><span class="t"> <span class="nam">field_name</span> <span class="op">=</span> <span class="nam">nodes_being_relocated</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2712" href="#t2712">2712</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_regenerate_relative_kvapir_order</span><span class="op">(</span><span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2713" href="#t2713">2713</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2714" href="#t2714">2714</a></span><span class="t"> <span class="key">def</span> <span class="nam">_regenerate_relative_kvapir_order</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">field_name</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2715" href="#t2715">2715</a></span><span class="t"> <span class="com"># type: (_strI) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2716" href="#t2716">2716</a></span><span class="t"> <span class="nam">nodes</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2717" href="#t2717">2717</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">iter_nodes</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2718" href="#t2718">2718</a></span><span class="t"> <span class="key">if</span> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span> <span class="op">==</span> <span class="nam">field_name</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2719" href="#t2719">2719</a></span><span class="t"> <span class="nam">nodes</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2720" href="#t2720">2720</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">field_name</span><span class="op">]</span> <span class="op">=</span> <span class="nam">nodes</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2721" href="#t2721">2721</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2722" href="#t2722">2722</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2723" href="#t2723">2723</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2724" href="#t2724">2724</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2725" href="#t2725">2725</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2726" href="#t2726">2726</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2727" href="#t2727">2727</a></span><span class="t"> <span class="key">def</span> <span class="nam">kvpair_count</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2728" href="#t2728">2728</a></span><span class="t"> <span class="com"># type: () -> int</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2729" href="#t2729">2729</a></span><span class="t"> <span class="key">return</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2730" href="#t2730">2730</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2731" href="#t2731">2731</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_keys</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2732" href="#t2732">2732</a></span><span class="t"> <span class="com"># type: () -> Iterable[ParagraphKey]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2733" href="#t2733">2733</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="op">(</span><span class="nam">kv</span><span class="op">.</span><span class="nam">field_name</span> <span class="key">for</span> <span class="nam">kv</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2734" href="#t2734">2734</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2735" href="#t2735">2735</a></span><span class="t"> <span class="key">def</span> <span class="nam">_resolve_to_single_node</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2736" href="#t2736">2736</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2737" href="#t2737">2737</a></span><span class="t"> <span class="nam">nodes</span><span class="op">,</span> <span class="com"># type: List[KVPNode]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2738" href="#t2738">2738</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="com"># type: str</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2739" href="#t2739">2739</a></span><span class="t"> <span class="nam">index</span><span class="op">,</span> <span class="com"># type: Optional[int]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2740" href="#t2740">2740</a></span><span class="t"> <span class="nam">name_token</span><span class="op">,</span> <span class="com"># type: Optional[Deb822FieldNameToken]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2741" href="#t2741">2741</a></span><span class="t"> <span class="nam">use_get</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2742" href="#t2742">2742</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2743" href="#t2743">2743</a></span><span class="t"> <span class="com"># type: (...) -> Optional[KVPNode]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2744" href="#t2744">2744</a></span><span class="t"> <span class="key">if</span> <span class="nam">index</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2745" href="#t2745">2745</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">!=</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2746" href="#t2746">2746</a></span><span class="t"> <span class="key">if</span> <span class="nam">name_token</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2747" href="#t2747">2747</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_find_node_via_name_token</span><span class="op">(</span><span class="nam">name_token</span><span class="op">,</span> <span class="nam">nodes</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2748" href="#t2748">2748</a></span><span class="t"> <span class="key">if</span> <span class="nam">node</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2749" href="#t2749">2749</a></span><span class="t"> <span class="key">return</span> <span class="nam">node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2750" href="#t2750">2750</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2751" href="#t2751">2751</a></span><span class="t"> <span class="str">"Ambiguous key {key} - the field appears {res_len} times. Use"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2752" href="#t2752">2752</a></span><span class="t"> <span class="str">" ({key}, index) to denote which instance of the field you want. (Index"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2753" href="#t2753">2753</a></span><span class="t"> <span class="str">" can be 0..{res_len_1} or e.g. -1 to denote the last field)"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2754" href="#t2754">2754</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2755" href="#t2755">2755</a></span><span class="t"> <span class="key">raise</span> <span class="nam">AmbiguousDeb822FieldKeyError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2756" href="#t2756">2756</a></span><span class="t"> <span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">key</span><span class="op">=</span><span class="nam">key</span><span class="op">,</span> <span class="nam">res_len</span><span class="op">=</span><span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span><span class="op">,</span> <span class="nam">res_len_1</span><span class="op">=</span><span class="nam">len</span><span class="op">(</span><span class="nam">nodes</span><span class="op">)</span> <span class="op">-</span> <span class="num">1</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2757" href="#t2757">2757</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2758" href="#t2758">2758</a></span><span class="t"> <span class="nam">index</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2759" href="#t2759">2759</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2760" href="#t2760">2760</a></span><span class="t"> <span class="key">return</span> <span class="nam">nodes</span><span class="op">[</span><span class="nam">index</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2761" href="#t2761">2761</a></span><span class="t"> <span class="key">except</span> <span class="nam">IndexError</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2762" href="#t2762">2762</a></span><span class="t"> <span class="key">if</span> <span class="nam">use_get</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2763" href="#t2763">2763</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2764" href="#t2764">2764</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="str">'Field "{key}" was present but the index "{index}" was invalid.'</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2765" href="#t2765">2765</a></span><span class="t"> <span class="key">raise</span> <span class="nam">KeyError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">key</span><span class="op">=</span><span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">=</span><span class="nam">index</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2766" href="#t2766">2766</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2767" href="#t2767">2767</a></span><span class="t"> <span class="key">def</span> <span class="nam">get_kvpair_element</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2768" href="#t2768">2768</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2769" href="#t2769">2769</a></span><span class="t"> <span class="nam">item</span><span class="op">,</span> <span class="com"># type: ParagraphKey</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2770" href="#t2770">2770</a></span><span class="t"> <span class="nam">use_get</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2771" href="#t2771">2771</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2772" href="#t2772">2772</a></span><span class="t"> <span class="com"># type: (...) -> Optional[Deb822KeyValuePairElement]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2773" href="#t2773">2773</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">,</span> <span class="nam">name_token</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2774" href="#t2774">2774</a></span><span class="t"> <span class="key">if</span> <span class="nam">use_get</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2775" href="#t2775">2775</a></span><span class="t"> <span class="nam">nodes</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2776" href="#t2776">2776</a></span><span class="t"> <span class="key">if</span> <span class="nam">nodes</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2777" href="#t2777">2777</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2778" href="#t2778">2778</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2779" href="#t2779">2779</a></span><span class="t"> <span class="nam">nodes</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2780" href="#t2780">2780</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_resolve_to_single_node</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2781" href="#t2781">2781</a></span><span class="t"> <span class="nam">nodes</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">,</span> <span class="nam">name_token</span><span class="op">,</span> <span class="nam">use_get</span><span class="op">=</span><span class="nam">use_get</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2782" href="#t2782">2782</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2783" href="#t2783">2783</a></span><span class="t"> <span class="key">if</span> <span class="nam">node</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2784" href="#t2784">2784</a></span><span class="t"> <span class="key">return</span> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2785" href="#t2785">2785</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2786" href="#t2786">2786</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2787" href="#t2787">2787</a></span><span class="t"> <span class="op">@</span><span class="nam">staticmethod</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2788" href="#t2788">2788</a></span><span class="t"> <span class="key">def</span> <span class="nam">_find_node_via_name_token</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2789" href="#t2789">2789</a></span><span class="t"> <span class="nam">name_token</span><span class="op">,</span> <span class="com"># type: Deb822FieldNameToken</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2790" href="#t2790">2790</a></span><span class="t"> <span class="nam">elements</span><span class="op">,</span> <span class="com"># type: Iterable[KVPNode]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2791" href="#t2791">2791</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2792" href="#t2792">2792</a></span><span class="t"> <span class="com"># type: (...) -> Optional[KVPNode]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2793" href="#t2793">2793</a></span><span class="t"> <span class="com"># if we are given a name token, then it is non-ambiguous if we have exactly</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2794" href="#t2794">2794</a></span><span class="t"> <span class="com"># that name token in our list of nodes. It will be an O(n) lookup but we</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2795" href="#t2795">2795</a></span><span class="t"> <span class="com"># probably do not have that many duplicate fields (and even if do, it is not</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2796" href="#t2796">2796</a></span><span class="t"> <span class="com"># exactly a valid file, so there little reason to optimize for it)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2797" href="#t2797">2797</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">elements</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2798" href="#t2798">2798</a></span><span class="t"> <span class="key">if</span> <span class="nam">name_token</span> <span class="key">is</span> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">field_token</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2799" href="#t2799">2799</a></span><span class="t"> <span class="key">return</span> <span class="nam">node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2800" href="#t2800">2800</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2801" href="#t2801">2801</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2802" href="#t2802">2802</a></span><span class="t"> <span class="key">def</span> <span class="nam">contains_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2803" href="#t2803">2803</a></span><span class="t"> <span class="com"># type: (object) -> bool</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2804" href="#t2804">2804</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="op">(</span><span class="nam">str</span><span class="op">,</span> <span class="nam">tuple</span><span class="op">,</span> <span class="nam">Deb822FieldNameToken</span><span class="op">)</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2805" href="#t2805">2805</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2806" href="#t2806">2806</a></span><span class="t"> <span class="nam">item</span> <span class="op">=</span> <span class="nam">cast</span><span class="op">(</span><span class="str">"ParagraphKey"</span><span class="op">,</span> <span class="nam">item</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2807" href="#t2807">2807</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2808" href="#t2808">2808</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">get_kvpair_element</span><span class="op">(</span><span class="nam">item</span><span class="op">,</span> <span class="nam">use_get</span><span class="op">=</span><span class="key">True</span><span class="op">)</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2809" href="#t2809">2809</a></span><span class="t"> <span class="key">except</span> <span class="nam">AmbiguousDeb822FieldKeyError</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2810" href="#t2810">2810</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2811" href="#t2811">2811</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2812" href="#t2812">2812</a></span><span class="t"> <span class="key">def</span> <span class="nam">set_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">,</span> <span class="nam">value</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2813" href="#t2813">2813</a></span><span class="t"> <span class="com"># type: (ParagraphKey, Deb822KeyValuePairElement) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2814" href="#t2814">2814</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">,</span> <span class="nam">name_token</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2815" href="#t2815">2815</a></span><span class="t"> <span class="key">if</span> <span class="nam">name_token</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2816" href="#t2816">2816</a></span><span class="t"> <span class="key">if</span> <span class="nam">name_token</span> <span class="key">is</span> <span class="key">not</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_token</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2817" href="#t2817">2817</a></span><span class="t"> <span class="nam">original_nodes</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2818" href="#t2818">2818</a></span><span class="t"> <span class="nam">original_node</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2819" href="#t2819">2819</a></span><span class="t"> <span class="key">if</span> <span class="nam">original_nodes</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2820" href="#t2820">2820</a></span><span class="t"> <span class="nam">original_node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_find_node_via_name_token</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2821" href="#t2821">2821</a></span><span class="t"> <span class="nam">name_token</span><span class="op">,</span> <span class="nam">original_nodes</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2822" href="#t2822">2822</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2823" href="#t2823">2823</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2824" href="#t2824">2824</a></span><span class="t"> <span class="key">if</span> <span class="nam">original_node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2825" href="#t2825">2825</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2826" href="#t2826">2826</a></span><span class="t"> <span class="str">"Key is a Deb822FieldNameToken, but not *the*"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2827" href="#t2827">2827</a></span><span class="t"> <span class="str">" Deb822FieldNameToken for the value nor the"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2828" href="#t2828">2828</a></span><span class="t"> <span class="str">" Deb822FieldNameToken for an existing field in the paragraph"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2829" href="#t2829">2829</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2830" href="#t2830">2830</a></span><span class="t"> <span class="com"># Primarily for mypy's sake</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2831" href="#t2831">2831</a></span><span class="t"> <span class="key">assert</span> <span class="nam">original_nodes</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2832" href="#t2832">2832</a></span><span class="t"> <span class="com"># Rely on the index-based code below to handle update.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2833" href="#t2833">2833</a></span><span class="t"> <span class="nam">index</span> <span class="op">=</span> <span class="nam">original_nodes</span><span class="op">.</span><span class="nam">index</span><span class="op">(</span><span class="nam">original_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2834" href="#t2834">2834</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2835" href="#t2835">2835</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2836" href="#t2836">2836</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span> <span class="op">!=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2837" href="#t2837">2837</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2838" href="#t2838">2838</a></span><span class="t"> <span class="str">"Cannot insert value under a different field value than field name"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2839" href="#t2839">2839</a></span><span class="t"> <span class="str">" from its Deb822FieldNameToken implies"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2840" href="#t2840">2840</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2841" href="#t2841">2841</a></span><span class="t"> <span class="com"># Use the string from the Deb822FieldNameToken as it is a _strI and has the same value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2842" href="#t2842">2842</a></span><span class="t"> <span class="com"># (memory optimization)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2843" href="#t2843">2843</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">value</span><span class="op">.</span><span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2844" href="#t2844">2844</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2845" href="#t2845">2845</a></span><span class="t"> <span class="nam">original_nodes</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2846" href="#t2846">2846</a></span><span class="t"> <span class="key">if</span> <span class="nam">original_nodes</span> <span class="key">is</span> <span class="key">None</span> <span class="key">or</span> <span class="key">not</span> <span class="nam">original_nodes</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2847" href="#t2847">2847</a></span><span class="t"> <span class="key">if</span> <span class="nam">index</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">index</span> <span class="op">!=</span> <span class="num">0</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2848" href="#t2848">2848</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2849" href="#t2849">2849</a></span><span class="t"> <span class="str">"Cannot replace field ({key}, {index}) as the field does not exist"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2850" href="#t2850">2850</a></span><span class="t"> <span class="str">" in the first place. Please index-less key or ({key}, 0) if you"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2851" href="#t2851">2851</a></span><span class="t"> <span class="str">" want to add the field."</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2852" href="#t2852">2852</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2853" href="#t2853">2853</a></span><span class="t"> <span class="key">raise</span> <span class="nam">KeyError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">key</span><span class="op">=</span><span class="nam">key</span><span class="op">,</span> <span class="nam">index</span><span class="op">=</span><span class="nam">index</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2854" href="#t2854">2854</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">value</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2855" href="#t2855">2855</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span> <span class="key">not</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2856" href="#t2856">2856</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="nam">node</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2857" href="#t2857">2857</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2858" href="#t2858">2858</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2859" href="#t2859">2859</a></span><span class="t"> <span class="key">return</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2860" href="#t2860">2860</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2861" href="#t2861">2861</a></span><span class="t"> <span class="nam">replace_all</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2862" href="#t2862">2862</a></span><span class="t"> <span class="key">if</span> <span class="nam">index</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2863" href="#t2863">2863</a></span><span class="t"> <span class="nam">replace_all</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2864" href="#t2864">2864</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">original_nodes</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2865" href="#t2865">2865</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">original_nodes</span><span class="op">)</span> <span class="op">!=</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2866" href="#t2866">2866</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="nam">node</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2867" href="#t2867">2867</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2868" href="#t2868">2868</a></span><span class="t"> <span class="com"># We insist on there being an original node, which as a side effect ensures</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2869" href="#t2869">2869</a></span><span class="t"> <span class="com"># you cannot add additional copies of the field. This means that you cannot</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2870" href="#t2870">2870</a></span><span class="t"> <span class="com"># make the problem worse.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2871" href="#t2871">2871</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">original_nodes</span><span class="op">[</span><span class="nam">index</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2872" href="#t2872">2872</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2873" href="#t2873">2873</a></span><span class="t"> <span class="com"># Replace the value of the existing node plus do a little dance</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2874" href="#t2874">2874</a></span><span class="t"> <span class="com"># for the parent element part.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2875" href="#t2875">2875</a></span><span class="t"> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2876" href="#t2876">2876</a></span><span class="t"> <span class="nam">value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2877" href="#t2877">2877</a></span><span class="t"> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span> <span class="op">=</span> <span class="nam">value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2878" href="#t2878">2878</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2879" href="#t2879">2879</a></span><span class="t"> <span class="key">if</span> <span class="nam">replace_all</span> <span class="key">and</span> <span class="nam">len</span><span class="op">(</span><span class="nam">original_nodes</span><span class="op">)</span> <span class="op">!=</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2880" href="#t2880">2880</a></span><span class="t"> <span class="com"># If we were in a replace-all mode, discard any remaining nodes</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2881" href="#t2881">2881</a></span><span class="t"> <span class="key">for</span> <span class="nam">n</span> <span class="key">in</span> <span class="nam">original_nodes</span><span class="op">[</span><span class="num">1</span><span class="op">:</span><span class="op">]</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2882" href="#t2882">2882</a></span><span class="t"> <span class="nam">n</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2883" href="#t2883">2883</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">n</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2884" href="#t2884">2884</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2885" href="#t2885">2885</a></span><span class="t"> <span class="key">def</span> <span class="nam">remove_kvpair_element</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2886" href="#t2886">2886</a></span><span class="t"> <span class="com"># type: (ParagraphKey) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2887" href="#t2887">2887</a></span><span class="t"> <span class="nam">key</span><span class="op">,</span> <span class="nam">idx</span><span class="op">,</span> <span class="nam">name_token</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2888" href="#t2888">2888</a></span><span class="t"> <span class="nam">field_list</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2889" href="#t2889">2889</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2890" href="#t2890">2890</a></span><span class="t"> <span class="key">if</span> <span class="nam">name_token</span> <span class="key">is</span> <span class="key">None</span> <span class="key">and</span> <span class="nam">idx</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2891" href="#t2891">2891</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2892" href="#t2892">2892</a></span><span class="t"> <span class="com"># Remove all case</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2893" href="#t2893">2893</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">field_list</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2894" href="#t2894">2894</a></span><span class="t"> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2895" href="#t2895">2895</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2896" href="#t2896">2896</a></span><span class="t"> <span class="key">del</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2897" href="#t2897">2897</a></span><span class="t"> <span class="key">return</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2898" href="#t2898">2898</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2899" href="#t2899">2899</a></span><span class="t"> <span class="key">if</span> <span class="nam">name_token</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2900" href="#t2900">2900</a></span><span class="t"> <span class="com"># Indirection between original_node and node for mypy's sake</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2901" href="#t2901">2901</a></span><span class="t"> <span class="nam">original_node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_find_node_via_name_token</span><span class="op">(</span><span class="nam">name_token</span><span class="op">,</span> <span class="nam">field_list</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2902" href="#t2902">2902</a></span><span class="t"> <span class="key">if</span> <span class="nam">original_node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2903" href="#t2903">2903</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="str">'The field "{key}" is present but key used to access it is not.'</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2904" href="#t2904">2904</a></span><span class="t"> <span class="key">raise</span> <span class="nam">KeyError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">key</span><span class="op">=</span><span class="nam">key</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2905" href="#t2905">2905</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">original_node</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2906" href="#t2906">2906</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2907" href="#t2907">2907</a></span><span class="t"> <span class="key">assert</span> <span class="nam">idx</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2908" href="#t2908">2908</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2909" href="#t2909">2909</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="nam">field_list</span><span class="op">[</span><span class="nam">idx</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2910" href="#t2910">2910</a></span><span class="t"> <span class="key">except</span> <span class="nam">KeyError</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2911" href="#t2911">2911</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="str">'The field "{key}" is present, but the index "{idx}" was invalid.'</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2912" href="#t2912">2912</a></span><span class="t"> <span class="key">raise</span> <span class="nam">KeyError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">key</span><span class="op">=</span><span class="nam">key</span><span class="op">,</span> <span class="nam">idx</span><span class="op">=</span><span class="nam">idx</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2913" href="#t2913">2913</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2914" href="#t2914">2914</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2915" href="#t2915">2915</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">field_list</span><span class="op">)</span> <span class="op">==</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2916" href="#t2916">2916</a></span><span class="t"> <span class="key">del</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span><span class="op">[</span><span class="nam">key</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2917" href="#t2917">2917</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2918" href="#t2918">2918</a></span><span class="t"> <span class="nam">field_list</span><span class="op">.</span><span class="nam">remove</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2919" href="#t2919">2919</a></span><span class="t"> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2920" href="#t2920">2920</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2921" href="#t2921">2921</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2922" href="#t2922">2922</a></span><span class="t"> <span class="key">def</span> <span class="nam">sort_fields</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">None</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2923" href="#t2923">2923</a></span><span class="t"> <span class="com"># type: (Optional[Callable[[str], Any]]) -> None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2924" href="#t2924">2924</a></span><span class="t"> <span class="str">"""Re-order all fields</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2925" href="#t2925">2925</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2926" href="#t2926">2926</a></span><span class="t"><span class="str"> :param key: Provide a key function (same semantics as for sorted). Keep in mind that</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2927" href="#t2927">2927</a></span><span class="t"><span class="str"> the module preserve the cases for field names - in generally, callers are recommended</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2928" href="#t2928">2928</a></span><span class="t"><span class="str"> to use "lower()" to normalize the case.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2929" href="#t2929">2929</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2930" href="#t2930">2930</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2931" href="#t2931">2931</a></span><span class="t"> <span class="key">if</span> <span class="nam">key</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2932" href="#t2932">2932</a></span><span class="t"> <span class="nam">key</span> <span class="op">=</span> <span class="nam">default_field_sort_key</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2933" href="#t2933">2933</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2934" href="#t2934">2934</a></span><span class="t"> <span class="com"># Work around mypy that cannot seem to shred the Optional notion</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2935" href="#t2935">2935</a></span><span class="t"> <span class="com"># without this little indirection</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2936" href="#t2936">2936</a></span><span class="t"> <span class="nam">key_impl</span> <span class="op">=</span> <span class="nam">key</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2937" href="#t2937">2937</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2938" href="#t2938">2938</a></span><span class="t"> <span class="key">def</span> <span class="nam">_actual_key</span><span class="op">(</span><span class="nam">kvpair</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2939" href="#t2939">2939</a></span><span class="t"> <span class="com"># type: (Deb822KeyValuePairElement) -> Any</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2940" href="#t2940">2940</a></span><span class="t"> <span class="key">return</span> <span class="nam">key_impl</span><span class="op">(</span><span class="nam">kvpair</span><span class="op">.</span><span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2941" href="#t2941">2941</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2942" href="#t2942">2942</a></span><span class="t"> <span class="key">for</span> <span class="nam">last_kvpair</span> <span class="key">in</span> <span class="nam">reversed</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2943" href="#t2943">2943</a></span><span class="t"> <span class="key">if</span> <span class="nam">last_kvpair</span><span class="op">.</span><span class="nam">value_element</span><span class="op">.</span><span class="nam">add_final_newline_if_missing</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2944" href="#t2944">2944</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2945" href="#t2945">2945</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2946" href="#t2946">2946</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2947" href="#t2947">2947</a></span><span class="t"> <span class="nam">sorted_kvpair_list</span> <span class="op">=</span> <span class="nam">sorted</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="nam">_actual_key</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2948" href="#t2948">2948</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_order</span> <span class="op">=</span> <span class="nam">LinkedList</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2949" href="#t2949">2949</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_kvpair_elements</span> <span class="op">=</span> <span class="op">{</span><span class="op">}</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2950" href="#t2950">2950</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_kvpair_fields</span><span class="op">(</span><span class="nam">sorted_kvpair_list</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2951" href="#t2951">2951</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2952" href="#t2952">2952</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2953" href="#t2953">2953</a></span><span class="t"><span class="key">class</span> <span class="nam">Deb822FileElement</span><span class="op">(</span><span class="nam">Deb822Element</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2954" href="#t2954">2954</a></span><span class="t"> <span class="str">"""Represents the entire deb822 file"""</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2955" href="#t2955">2955</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2956" href="#t2956">2956</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">token_and_elements</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2957" href="#t2957">2957</a></span><span class="t"> <span class="com"># type: (LinkedList[TokenOrElement]) -> None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2958" href="#t2958">2958</a></span><span class="t"> <span class="nam">super</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">__init__</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2959" href="#t2959">2959</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span> <span class="op">=</span> <span class="nam">token_and_elements</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2960" href="#t2960">2960</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_init_parent_of_parts</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2961" href="#t2961">2961</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2962" href="#t2962">2962</a></span><span class="t"> <span class="op">@</span><span class="nam">classmethod</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2963" href="#t2963">2963</a></span><span class="t"> <span class="key">def</span> <span class="nam">new_empty_file</span><span class="op">(</span><span class="nam">cls</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2964" href="#t2964">2964</a></span><span class="t"> <span class="com"># type: () -> Deb822FileElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2965" href="#t2965">2965</a></span><span class="t"> <span class="str">"""Creates a new Deb822FileElement with no contents</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2966" href="#t2966">2966</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2967" href="#t2967">2967</a></span><span class="t"><span class="str"> Note that a deb822 file must be non-empty to be considered valid</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2968" href="#t2968">2968</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2969" href="#t2969">2969</a></span><span class="t"> <span class="key">return</span> <span class="nam">cls</span><span class="op">(</span><span class="nam">LinkedList</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2970" href="#t2970">2970</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2971" href="#t2971">2971</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2972" href="#t2972">2972</a></span><span class="t"> <span class="key">def</span> <span class="nam">is_valid_file</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2973" href="#t2973">2973</a></span><span class="t"> <span class="com"># type: () -> bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2974" href="#t2974">2974</a></span><span class="t"> <span class="str">"""Returns true if the file is valid</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2975" href="#t2975">2975</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2976" href="#t2976">2976</a></span><span class="t"><span class="str"> Invalid elements include error elements (Deb822ErrorElement) but also</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2977" href="#t2977">2977</a></span><span class="t"><span class="str"> issues such as paragraphs with duplicate fields or "empty" files</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2978" href="#t2978">2978</a></span><span class="t"><span class="str"> (a valid deb822 file contains at least one paragraph).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2979" href="#t2979">2979</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2980" href="#t2980">2980</a></span><span class="t"> <span class="nam">had_paragraph</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2981" href="#t2981">2981</a></span><span class="t"> <span class="key">for</span> <span class="nam">paragraph</span> <span class="key">in</span> <span class="nam">self</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2982" href="#t2982">2982</a></span><span class="t"> <span class="nam">had_paragraph</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2983" href="#t2983">2983</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">paragraph</span> <span class="key">or</span> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">has_duplicate_fields</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2984" href="#t2984">2984</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2985" href="#t2985">2985</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2986" href="#t2986">2986</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">had_paragraph</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2987" href="#t2987">2987</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2988" href="#t2988">2988</a></span><span class="t"> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t2989" href="#t2989">2989</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">find_first_error_element</span><span class="op">(</span><span class="op">)</span> <span class="key">is</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2990" href="#t2990">2990</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2991" href="#t2991">2991</a></span><span class="t"> <span class="key">def</span> <span class="nam">find_first_error_element</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2992" href="#t2992">2992</a></span><span class="t"> <span class="com"># type: () -> Optional[Deb822ErrorElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2993" href="#t2993">2993</a></span><span class="t"> <span class="str">"""Returns the first Deb822ErrorElement (or None) in the file"""</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2994" href="#t2994">2994</a></span><span class="t"> <span class="key">return</span> <span class="nam">next</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2995" href="#t2995">2995</a></span><span class="t"> <span class="nam">iter</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">iter_recurse</span><span class="op">(</span><span class="nam">only_element_or_token_type</span><span class="op">=</span><span class="nam">Deb822ErrorElement</span><span class="op">)</span><span class="op">)</span><span class="op">,</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2996" href="#t2996">2996</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2997" href="#t2997">2997</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t2998" href="#t2998">2998</a></span><span class="t"> <span class="key">def</span> <span class="nam">__iter__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t2999" href="#t2999">2999</a></span><span class="t"> <span class="com"># type: () -> Iterator[Deb822ParagraphElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3000" href="#t3000">3000</a></span><span class="t"> <span class="key">return</span> <span class="nam">iter</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">iter_parts_of_type</span><span class="op">(</span><span class="nam">Deb822ParagraphElement</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3001" href="#t3001">3001</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3002" href="#t3002">3002</a></span><span class="t"> <span class="key">def</span> <span class="nam">iter_parts</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3003" href="#t3003">3003</a></span><span class="t"> <span class="com"># type: () -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3004" href="#t3004">3004</a></span><span class="t"> <span class="key">yield</span> <span class="key">from</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3005" href="#t3005">3005</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3006" href="#t3006">3006</a></span><span class="t"> <span class="key">def</span> <span class="nam">insert</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">idx</span><span class="op">,</span> <span class="nam">para</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3007" href="#t3007">3007</a></span><span class="t"> <span class="com"># type: (int, Deb822ParagraphElement) -> None</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t3008" href="#t3008">3008</a></span><span class="t"> <span class="str">"""Inserts a paragraph into the file at the given "index" of paragraphs</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3009" href="#t3009">3009</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3010" href="#t3010">3010</a></span><span class="t"><span class="str"> Note that if the index is between two paragraphs containing a "free</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3011" href="#t3011">3011</a></span><span class="t"><span class="str"> floating" comment (e.g. paragraph/start-of-file, empty line, comment,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3012" href="#t3012">3012</a></span><span class="t"><span class="str"> empty line, paragraph) then it is unspecified which "side" of the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3013" href="#t3013">3013</a></span><span class="t"><span class="str"> comment the new paragraph will appear and this may change between</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3014" href="#t3014">3014</a></span><span class="t"><span class="str"> versions of python-debian.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3015" href="#t3015">3015</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3016" href="#t3016">3016</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3017" href="#t3017">3017</a></span><span class="t"><span class="str"> >>> original = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3018" href="#t3018">3018</a></span><span class="t"><span class="str"> ... Package: libfoo-dev</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3019" href="#t3019">3019</a></span><span class="t"><span class="str"> ... Depends: libfoo1 (= ${binary:Version}), ${shlib:Depends}, ${misc:Depends}</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3020" href="#t3020">3020</a></span><span class="t"><span class="str"> ... '''.lstrip()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3021" href="#t3021">3021</a></span><span class="t"><span class="str"> >>> deb822_file = parse_deb822_file(original.splitlines())</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3022" href="#t3022">3022</a></span><span class="t"><span class="str"> >>> para1 = Deb822ParagraphElement.new_empty_paragraph()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3023" href="#t3023">3023</a></span><span class="t"><span class="str"> >>> para1["Source"] = "foo"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3024" href="#t3024">3024</a></span><span class="t"><span class="str"> >>> para1["Build-Depends"] = "debhelper-compat (= 13)"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3025" href="#t3025">3025</a></span><span class="t"><span class="str"> >>> para2 = Deb822ParagraphElement.new_empty_paragraph()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3026" href="#t3026">3026</a></span><span class="t"><span class="str"> >>> para2["Package"] = "libfoo1"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3027" href="#t3027">3027</a></span><span class="t"><span class="str"> >>> para2["Depends"] = "${shlib:Depends}, ${misc:Depends}"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3028" href="#t3028">3028</a></span><span class="t"><span class="str"> >>> deb822_file.insert(0, para1)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3029" href="#t3029">3029</a></span><span class="t"><span class="str"> >>> deb822_file.insert(1, para2)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3030" href="#t3030">3030</a></span><span class="t"><span class="str"> >>> expected = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3031" href="#t3031">3031</a></span><span class="t"><span class="str"> ... Source: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3032" href="#t3032">3032</a></span><span class="t"><span class="str"> ... Build-Depends: debhelper-compat (= 13)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3033" href="#t3033">3033</a></span><span class="t"><span class="str"> ...</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3034" href="#t3034">3034</a></span><span class="t"><span class="str"> ... Package: libfoo1</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3035" href="#t3035">3035</a></span><span class="t"><span class="str"> ... Depends: ${shlib:Depends}, ${misc:Depends}</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3036" href="#t3036">3036</a></span><span class="t"><span class="str"> ...</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3037" href="#t3037">3037</a></span><span class="t"><span class="str"> ... Package: libfoo-dev</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3038" href="#t3038">3038</a></span><span class="t"><span class="str"> ... Depends: libfoo1 (= ${binary:Version}), ${shlib:Depends}, ${misc:Depends}</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3039" href="#t3039">3039</a></span><span class="t"><span class="str"> ... '''.lstrip()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3040" href="#t3040">3040</a></span><span class="t"><span class="str"> >>> deb822_file.dump() == expected</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3041" href="#t3041">3041</a></span><span class="t"><span class="str"> True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3042" href="#t3042">3042</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3043" href="#t3043">3043</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3044" href="#t3044">3044</a></span><span class="t"> <span class="nam">anchor_node</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3045" href="#t3045">3045</a></span><span class="t"> <span class="nam">needs_newline</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3046" href="#t3046">3046</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3047" href="#t3047">3047</a></span><span class="t"> <span class="key">if</span> <span class="nam">idx</span> <span class="op">==</span> <span class="num">0</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3048" href="#t3048">3048</a></span><span class="t"> <span class="com"># Special-case, if idx is 0, then we insert it before everything else.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3049" href="#t3049">3049</a></span><span class="t"> <span class="com"># This is mostly a cosmetic choice for corner cases involving free-floating</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3050" href="#t3050">3050</a></span><span class="t"> <span class="com"># comments in the file.</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3051" href="#t3051">3051</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3051 ↛ 3052</span><span class="annotate long">line 3051 didn't jump to line 3052, because the condition on line 3051 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t3052" href="#t3052">3052</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">para</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3053" href="#t3053">3053</a></span><span class="t"> <span class="key">return</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3054" href="#t3054">3054</a></span><span class="t"> <span class="nam">anchor_node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">head_node</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3055" href="#t3055">3055</a></span><span class="t"> <span class="nam">needs_newline</span> <span class="op">=</span> <span class="nam">bool</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3056" href="#t3056">3056</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3057" href="#t3057">3057</a></span><span class="t"> <span class="nam">i</span> <span class="op">=</span> <span class="num">0</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3058" href="#t3058">3058</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">iter_nodes</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3058 ↛ 3066</span><span class="annotate long">line 3058 didn't jump to line 3066, because the loop on line 3058 didn't complete</span></span></p> + <p class="run"><span class="n"><a id="t3059" href="#t3059">3059</a></span><span class="t"> <span class="nam">entry</span> <span class="op">=</span> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3060" href="#t3060">3060</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">entry</span><span class="op">,</span> <span class="nam">Deb822ParagraphElement</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3061" href="#t3061">3061</a></span><span class="t"> <span class="nam">i</span> <span class="op">+=</span> <span class="num">1</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3062" href="#t3062">3062</a></span><span class="t"> <span class="key">if</span> <span class="nam">idx</span> <span class="op">==</span> <span class="nam">i</span> <span class="op">-</span> <span class="num">1</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3063" href="#t3063">3063</a></span><span class="t"> <span class="nam">anchor_node</span> <span class="op">=</span> <span class="nam">node</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3064" href="#t3064">3064</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3065" href="#t3065">3065</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3066" href="#t3066">3066</a></span><span class="t"> <span class="key">if</span> <span class="nam">anchor_node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3066 ↛ 3068</span><span class="annotate long">line 3066 didn't jump to line 3068, because the condition on line 3066 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t3067" href="#t3067">3067</a></span><span class="t"> <span class="com"># Empty list or idx after the last paragraph both degenerate into append</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3068" href="#t3068">3068</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">para</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3069" href="#t3069">3069</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3070" href="#t3070">3070</a></span><span class="t"> <span class="key">if</span> <span class="nam">needs_newline</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3070 ↛ 3076</span><span class="annotate long">line 3070 didn't jump to line 3076, because the condition on line 3070 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t3071" href="#t3071">3071</a></span><span class="t"> <span class="com"># Remember to inject the "separating" newline between two paragraphs</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3072" href="#t3072">3072</a></span><span class="t"> <span class="nam">nl_token</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_set_parent</span><span class="op">(</span><span class="nam">Deb822WhitespaceToken</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3073" href="#t3073">3073</a></span><span class="t"> <span class="nam">anchor_node</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">insert_before</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3074" href="#t3074">3074</a></span><span class="t"> <span class="nam">nl_token</span><span class="op">,</span> <span class="nam">anchor_node</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3075" href="#t3075">3075</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3076" href="#t3076">3076</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">insert_before</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_set_parent</span><span class="op">(</span><span class="nam">para</span><span class="op">)</span><span class="op">,</span> <span class="nam">anchor_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3077" href="#t3077">3077</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3078" href="#t3078">3078</a></span><span class="t"> <span class="key">def</span> <span class="nam">append</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">paragraph</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3079" href="#t3079">3079</a></span><span class="t"> <span class="com"># type: (Deb822ParagraphElement) -> None</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t3080" href="#t3080">3080</a></span><span class="t"> <span class="str">"""Appends a paragraph to the file</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3081" href="#t3081">3081</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3082" href="#t3082">3082</a></span><span class="t"><span class="str"> >>> deb822_file = Deb822FileElement.new_empty_file()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3083" href="#t3083">3083</a></span><span class="t"><span class="str"> >>> para1 = Deb822ParagraphElement.new_empty_paragraph()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3084" href="#t3084">3084</a></span><span class="t"><span class="str"> >>> para1["Source"] = "foo"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3085" href="#t3085">3085</a></span><span class="t"><span class="str"> >>> para1["Build-Depends"] = "debhelper-compat (= 13)"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3086" href="#t3086">3086</a></span><span class="t"><span class="str"> >>> para2 = Deb822ParagraphElement.new_empty_paragraph()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3087" href="#t3087">3087</a></span><span class="t"><span class="str"> >>> para2["Package"] = "foo"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3088" href="#t3088">3088</a></span><span class="t"><span class="str"> >>> para2["Depends"] = "${shlib:Depends}, ${misc:Depends}"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3089" href="#t3089">3089</a></span><span class="t"><span class="str"> >>> deb822_file.append(para1)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3090" href="#t3090">3090</a></span><span class="t"><span class="str"> >>> deb822_file.append(para2)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3091" href="#t3091">3091</a></span><span class="t"><span class="str"> >>> expected = '''</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3092" href="#t3092">3092</a></span><span class="t"><span class="str"> ... Source: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3093" href="#t3093">3093</a></span><span class="t"><span class="str"> ... Build-Depends: debhelper-compat (= 13)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3094" href="#t3094">3094</a></span><span class="t"><span class="str"> ...</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3095" href="#t3095">3095</a></span><span class="t"><span class="str"> ... Package: foo</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3096" href="#t3096">3096</a></span><span class="t"><span class="str"> ... Depends: ${shlib:Depends}, ${misc:Depends}</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3097" href="#t3097">3097</a></span><span class="t"><span class="str"> ... '''.lstrip()</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3098" href="#t3098">3098</a></span><span class="t"><span class="str"> >>> deb822_file.dump() == expected</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3099" href="#t3099">3099</a></span><span class="t"><span class="str"> True</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3100" href="#t3100">3100</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3101" href="#t3101">3101</a></span><span class="t"> <span class="nam">tail_element</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">tail</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3102" href="#t3102">3102</a></span><span class="t"> <span class="key">if</span> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">parent_element</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3102 ↛ 3103</span><span class="annotate long">line 3102 didn't jump to line 3103, because the condition on line 3102 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t3103" href="#t3103">3103</a></span><span class="t"> <span class="key">if</span> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">parent_element</span> <span class="key">is</span> <span class="nam">self</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3104" href="#t3104">3104</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Paragraph is already a part of this file"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3105" href="#t3105">3105</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Paragraph is already part of another Deb822File"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3106" href="#t3106">3106</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3107" href="#t3107">3107</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3108" href="#t3108">3108</a></span><span class="t"> <span class="com"># We need a separating newline if there is not a whitespace token at the end of the file.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3109" href="#t3109">3109</a></span><span class="t"> <span class="com"># Note the special case where the file ends on a comment; here we insert a whitespace too</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3110" href="#t3110">3110</a></span><span class="t"> <span class="com"># to be sure. Otherwise, we would have to check that there is an empty line before that</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3111" href="#t3111">3111</a></span><span class="t"> <span class="com"># comment and that is too much effort.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3112" href="#t3112">3112</a></span><span class="t"> <span class="key">if</span> <span class="nam">tail_element</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">tail_element</span><span class="op">,</span> <span class="nam">Deb822WhitespaceToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3113" href="#t3113">3113</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3114" href="#t3114">3114</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_set_parent</span><span class="op">(</span><span class="nam">Deb822WhitespaceToken</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3115" href="#t3115">3115</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3116" href="#t3116">3116</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_set_parent</span><span class="op">(</span><span class="nam">paragraph</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3117" href="#t3117">3117</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3118" href="#t3118">3118</a></span><span class="t"> <span class="key">def</span> <span class="nam">remove</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">paragraph</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3119" href="#t3119">3119</a></span><span class="t"> <span class="com"># type: (Deb822ParagraphElement) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3120" href="#t3120">3120</a></span><span class="t"> <span class="key">if</span> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">parent_element</span> <span class="key">is</span> <span class="key">not</span> <span class="nam">self</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3121" href="#t3121">3121</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="str">"Paragraph is part of a different file"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3122" href="#t3122">3122</a></span><span class="t"> <span class="nam">node</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3123" href="#t3123">3123</a></span><span class="t"> <span class="key">for</span> <span class="nam">node</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">iter_nodes</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3124" href="#t3124">3124</a></span><span class="t"> <span class="key">if</span> <span class="nam">node</span><span class="op">.</span><span class="nam">value</span> <span class="key">is</span> <span class="nam">paragraph</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3125" href="#t3125">3125</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3126" href="#t3126">3126</a></span><span class="t"> <span class="key">if</span> <span class="nam">node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3127" href="#t3127">3127</a></span><span class="t"> <span class="key">raise</span> <span class="nam">RuntimeError</span><span class="op">(</span><span class="str">"unable to find paragraph"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3128" href="#t3128">3128</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_full_size_cache</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3129" href="#t3129">3129</a></span><span class="t"> <span class="nam">previous_node</span> <span class="op">=</span> <span class="nam">node</span><span class="op">.</span><span class="nam">previous_node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3130" href="#t3130">3130</a></span><span class="t"> <span class="nam">next_node</span> <span class="op">=</span> <span class="nam">node</span><span class="op">.</span><span class="nam">next_node</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3131" href="#t3131">3131</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3132" href="#t3132">3132</a></span><span class="t"> <span class="key">if</span> <span class="nam">next_node</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3133" href="#t3133">3133</a></span><span class="t"> <span class="key">if</span> <span class="nam">previous_node</span> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">previous_node</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span> <span class="nam">Deb822WhitespaceToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3134" href="#t3134">3134</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">previous_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3135" href="#t3135">3135</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3136" href="#t3136">3136</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">next_node</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span> <span class="nam">Deb822WhitespaceToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3137" href="#t3137">3137</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_token_and_elements</span><span class="op">.</span><span class="nam">remove_node</span><span class="op">(</span><span class="nam">next_node</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3138" href="#t3138">3138</a></span><span class="t"> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3139" href="#t3139">3139</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3140" href="#t3140">3140</a></span><span class="t"> <span class="key">def</span> <span class="nam">_set_parent</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">t</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3141" href="#t3141">3141</a></span><span class="t"> <span class="com"># type: (TE) -> TE</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3142" href="#t3142">3142</a></span><span class="t"> <span class="nam">t</span><span class="op">.</span><span class="nam">parent_element</span> <span class="op">=</span> <span class="nam">self</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3143" href="#t3143">3143</a></span><span class="t"> <span class="key">return</span> <span class="nam">t</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3144" href="#t3144">3144</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3145" href="#t3145">3145</a></span><span class="t"> <span class="key">def</span> <span class="nam">position_in_parent</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Position</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3146" href="#t3146">3146</a></span><span class="t"> <span class="com"># Recursive base-case</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3147" href="#t3147">3147</a></span><span class="t"> <span class="key">return</span> <span class="nam">START_POSITION</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3148" href="#t3148">3148</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3149" href="#t3149">3149</a></span><span class="t"> <span class="key">def</span> <span class="nam">position_in_file</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="op">*</span><span class="op">,</span> <span class="nam">skip_leading_comments</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Position</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3150" href="#t3150">3150</a></span><span class="t"> <span class="com"># By definition</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3151" href="#t3151">3151</a></span><span class="t"> <span class="key">return</span> <span class="nam">START_POSITION</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3152" href="#t3152">3152</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3153" href="#t3153">3153</a></span><span class="t"> <span class="op">@</span><span class="nam">overload</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3154" href="#t3154">3154</a></span><span class="t"> <span class="key">def</span> <span class="nam">dump</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3155" href="#t3155">3155</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">fd</span> <span class="com"># type: IO[bytes]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3156" href="#t3156">3156</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3157" href="#t3157">3157</a></span><span class="t"> <span class="com"># type: (...) -> None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3158" href="#t3158">3158</a></span><span class="t"> <span class="key">pass</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3159" href="#t3159">3159</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3160" href="#t3160">3160</a></span><span class="t"> <span class="op">@</span><span class="nam">overload</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3161" href="#t3161">3161</a></span><span class="t"> <span class="key">def</span> <span class="nam">dump</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3162" href="#t3162">3162</a></span><span class="t"> <span class="com"># type: () -> str</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3163" href="#t3163">3163</a></span><span class="t"> <span class="key">pass</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3164" href="#t3164">3164</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3165" href="#t3165">3165</a></span><span class="t"> <span class="key">def</span> <span class="nam">dump</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3166" href="#t3166">3166</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span> <span class="nam">fd</span><span class="op">=</span><span class="key">None</span> <span class="com"># type: Optional[IO[bytes]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3167" href="#t3167">3167</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3168" href="#t3168">3168</a></span><span class="t"> <span class="com"># type: (...) -> Optional[str]</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3169" href="#t3169">3169</a></span><span class="t"> <span class="key">if</span> <span class="nam">fd</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3169 ↛ 3171</span><span class="annotate long">line 3169 didn't jump to line 3171, because the condition on line 3169 was never false</span></span></p> + <p class="run"><span class="n"><a id="t3170" href="#t3170">3170</a></span><span class="t"> <span class="key">return</span> <span class="str">""</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">t</span><span class="op">.</span><span class="nam">text</span> <span class="key">for</span> <span class="nam">t</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3171" href="#t3171">3171</a></span><span class="t"> <span class="key">for</span> <span class="nam">token</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">iter_tokens</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3172" href="#t3172">3172</a></span><span class="t"> <span class="nam">fd</span><span class="op">.</span><span class="nam">write</span><span class="op">(</span><span class="nam">token</span><span class="op">.</span><span class="nam">text</span><span class="op">.</span><span class="nam">encode</span><span class="op">(</span><span class="str">"utf-8"</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3173" href="#t3173">3173</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3174" href="#t3174">3174</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3175" href="#t3175">3175</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3176" href="#t3176">3176</a></span><span class="t"><span class="nam">_combine_error_tokens_into_elements</span> <span class="op">=</span> <span class="nam">combine_into_replacement</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3177" href="#t3177">3177</a></span><span class="t"> <span class="nam">Deb822ErrorToken</span><span class="op">,</span> <span class="nam">Deb822ErrorElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3178" href="#t3178">3178</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3179" href="#t3179">3179</a></span><span class="t"><span class="nam">_combine_comment_tokens_into_elements</span> <span class="op">=</span> <span class="nam">combine_into_replacement</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3180" href="#t3180">3180</a></span><span class="t"> <span class="nam">Deb822CommentToken</span><span class="op">,</span> <span class="nam">Deb822CommentElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3181" href="#t3181">3181</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3182" href="#t3182">3182</a></span><span class="t"><span class="nam">_combine_vl_elements_into_value_elements</span> <span class="op">=</span> <span class="nam">combine_into_replacement</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3183" href="#t3183">3183</a></span><span class="t"> <span class="nam">Deb822ValueLineElement</span><span class="op">,</span> <span class="nam">Deb822ValueElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3184" href="#t3184">3184</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3185" href="#t3185">3185</a></span><span class="t"><span class="nam">_combine_kvp_elements_into_paragraphs</span> <span class="op">=</span> <span class="nam">combine_into_replacement</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3186" href="#t3186">3186</a></span><span class="t"> <span class="nam">Deb822KeyValuePairElement</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3187" href="#t3187">3187</a></span><span class="t"> <span class="nam">Deb822ParagraphElement</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3188" href="#t3188">3188</a></span><span class="t"> <span class="nam">constructor</span><span class="op">=</span><span class="nam">Deb822ParagraphElement</span><span class="op">.</span><span class="nam">from_kvpairs</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3189" href="#t3189">3189</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3190" href="#t3190">3190</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3191" href="#t3191">3191</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3192" href="#t3192">3192</a></span><span class="t"><span class="key">def</span> <span class="nam">_parsed_value_render_factory</span><span class="op">(</span><span class="nam">discard_comments</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3193" href="#t3193">3193</a></span><span class="t"> <span class="com"># type: (bool) -> Callable[[Deb822ParsedValueElement], str]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3194" href="#t3194">3194</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3195" href="#t3195">3195</a></span><span class="t"> <span class="nam">Deb822ParsedValueElement</span><span class="op">.</span><span class="nam">convert_to_text_without_comments</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3196" href="#t3196">3196</a></span><span class="t"> <span class="key">if</span> <span class="nam">discard_comments</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3197" href="#t3197">3197</a></span><span class="t"> <span class="key">else</span> <span class="nam">Deb822ParsedValueElement</span><span class="op">.</span><span class="nam">convert_to_text</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3198" href="#t3198">3198</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3199" href="#t3199">3199</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3200" href="#t3200">3200</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3201" href="#t3201">3201</a></span><span class="t"><span class="nam">LIST_SPACE_SEPARATED_INTERPRETATION</span> <span class="op">=</span> <span class="nam">ListInterpretation</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3202" href="#t3202">3202</a></span><span class="t"> <span class="nam">whitespace_split_tokenizer</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3203" href="#t3203">3203</a></span><span class="t"> <span class="nam">_parse_whitespace_list_value</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3204" href="#t3204">3204</a></span><span class="t"> <span class="nam">Deb822ParsedValueElement</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3205" href="#t3205">3205</a></span><span class="t"> <span class="nam">Deb822SemanticallySignificantWhiteSpace</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3206" href="#t3206">3206</a></span><span class="t"> <span class="key">lambda</span><span class="op">:</span> <span class="nam">Deb822SpaceSeparatorToken</span><span class="op">(</span><span class="str">" "</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3207" href="#t3207">3207</a></span><span class="t"> <span class="nam">_parsed_value_render_factory</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3208" href="#t3208">3208</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3209" href="#t3209">3209</a></span><span class="t"><span class="nam">LIST_COMMA_SEPARATED_INTERPRETATION</span> <span class="op">=</span> <span class="nam">ListInterpretation</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3210" href="#t3210">3210</a></span><span class="t"> <span class="nam">comma_split_tokenizer</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3211" href="#t3211">3211</a></span><span class="t"> <span class="nam">_parse_comma_list_value</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3212" href="#t3212">3212</a></span><span class="t"> <span class="nam">Deb822ParsedValueElement</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3213" href="#t3213">3213</a></span><span class="t"> <span class="nam">Deb822CommaToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3214" href="#t3214">3214</a></span><span class="t"> <span class="nam">Deb822CommaToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3215" href="#t3215">3215</a></span><span class="t"> <span class="nam">_parsed_value_render_factory</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3216" href="#t3216">3216</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3217" href="#t3217">3217</a></span><span class="t"><span class="nam">LIST_UPLOADERS_INTERPRETATION</span> <span class="op">=</span> <span class="nam">ListInterpretation</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3218" href="#t3218">3218</a></span><span class="t"> <span class="nam">comma_split_tokenizer</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3219" href="#t3219">3219</a></span><span class="t"> <span class="nam">_parse_uploaders_list_value</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3220" href="#t3220">3220</a></span><span class="t"> <span class="nam">Deb822ParsedValueElement</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3221" href="#t3221">3221</a></span><span class="t"> <span class="nam">Deb822CommaToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3222" href="#t3222">3222</a></span><span class="t"> <span class="nam">Deb822CommaToken</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3223" href="#t3223">3223</a></span><span class="t"> <span class="nam">_parsed_value_render_factory</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3224" href="#t3224">3224</a></span><span class="t"><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3225" href="#t3225">3225</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3226" href="#t3226">3226</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3227" href="#t3227">3227</a></span><span class="t"><span class="key">def</span> <span class="nam">_non_end_of_line_token</span><span class="op">(</span><span class="nam">v</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3228" href="#t3228">3228</a></span><span class="t"> <span class="com"># type: (TokenOrElement) -> bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3229" href="#t3229">3229</a></span><span class="t"> <span class="com"># Consume tokens until the newline</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3230" href="#t3230">3230</a></span><span class="t"> <span class="key">return</span> <span class="key">not</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">v</span><span class="op">,</span> <span class="nam">Deb822WhitespaceToken</span><span class="op">)</span> <span class="key">or</span> <span class="nam">v</span><span class="op">.</span><span class="nam">text</span> <span class="op">!=</span> <span class="str">"\n"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3231" href="#t3231">3231</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3232" href="#t3232">3232</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3233" href="#t3233">3233</a></span><span class="t"><span class="key">def</span> <span class="nam">_build_value_line</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3234" href="#t3234">3234</a></span><span class="t"> <span class="nam">token_stream</span><span class="op">,</span> <span class="com"># type: Iterable[Union[TokenOrElement, Deb822CommentElement]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3235" href="#t3235">3235</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3236" href="#t3236">3236</a></span><span class="t"> <span class="com"># type: (...) -> Iterable[Union[TokenOrElement, Deb822ValueLineElement]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3237" href="#t3237">3237</a></span><span class="t"> <span class="str">"""Parser helper - consumes tokens part of a Deb822ValueEntryElement and turns them into one"""</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3238" href="#t3238">3238</a></span><span class="t"> <span class="nam">buffered_stream</span> <span class="op">=</span> <span class="nam">BufferingIterator</span><span class="op">(</span><span class="nam">token_stream</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3239" href="#t3239">3239</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3240" href="#t3240">3240</a></span><span class="t"> <span class="com"># Deb822ValueLineElement is a bit tricky because of how we handle whitespace</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3241" href="#t3241">3241</a></span><span class="t"> <span class="com"># and comments.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3242" href="#t3242">3242</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3243" href="#t3243">3243</a></span><span class="t"> <span class="com"># In relation to comments, then only continuation lines can have comments.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3244" href="#t3244">3244</a></span><span class="t"> <span class="com"># If there is a comment before a "K: V" line, then the comment is associated</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3245" href="#t3245">3245</a></span><span class="t"> <span class="com"># with the field rather than the value.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3246" href="#t3246">3246</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3247" href="#t3247">3247</a></span><span class="t"> <span class="com"># On the whitespace front, then we separate syntactical mandatory whitespace</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3248" href="#t3248">3248</a></span><span class="t"> <span class="com"># from optional whitespace. As an example:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3249" href="#t3249">3249</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3250" href="#t3250">3250</a></span><span class="t"> <span class="com"># """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3251" href="#t3251">3251</a></span><span class="t"> <span class="com"># # some comment associated with the Depends field</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3252" href="#t3252">3252</a></span><span class="t"> <span class="com"># Depends:_foo_$</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3253" href="#t3253">3253</a></span><span class="t"> <span class="com"># # some comment associated with the line containing "bar"</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3254" href="#t3254">3254</a></span><span class="t"> <span class="com"># !________bar_$</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3255" href="#t3255">3255</a></span><span class="t"> <span class="com"># """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3256" href="#t3256">3256</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3257" href="#t3257">3257</a></span><span class="t"> <span class="com"># Where "$" and "!" represents mandatory whitespace (the newline and the first</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3258" href="#t3258">3258</a></span><span class="t"> <span class="com"># space are required for the file to be parsed correctly), where as "_" is</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3259" href="#t3259">3259</a></span><span class="t"> <span class="com"># "optional" whitespace (from a syntactical point of view).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3260" href="#t3260">3260</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3261" href="#t3261">3261</a></span><span class="t"> <span class="com"># This distinction enable us to facilitate APIs for easy removal/normalization</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3262" href="#t3262">3262</a></span><span class="t"> <span class="com"># of redundant whitespaces without having programmers worry about trashing</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3263" href="#t3263">3263</a></span><span class="t"> <span class="com"># the file.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3264" href="#t3264">3264</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3265" href="#t3265">3265</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3266" href="#t3266">3266</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3267" href="#t3267">3267</a></span><span class="t"> <span class="nam">comment_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3268" href="#t3268">3268</a></span><span class="t"> <span class="nam">continuation_line_token</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3269" href="#t3269">3269</a></span><span class="t"> <span class="nam">token</span> <span class="op">=</span> <span class="key">None</span> <span class="com"># type: Optional[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3270" href="#t3270">3270</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3271" href="#t3271">3271</a></span><span class="t"> <span class="key">for</span> <span class="nam">token</span> <span class="key">in</span> <span class="nam">buffered_stream</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3272" href="#t3272">3272</a></span><span class="t"> <span class="nam">start_of_value_entry</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3273" href="#t3273">3273</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">Deb822ValueContinuationToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3274" href="#t3274">3274</a></span><span class="t"> <span class="nam">continuation_line_token</span> <span class="op">=</span> <span class="nam">token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3275" href="#t3275">3275</a></span><span class="t"> <span class="nam">start_of_value_entry</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3276" href="#t3276">3276</a></span><span class="t"> <span class="nam">token</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3277" href="#t3277">3277</a></span><span class="t"> <span class="key">elif</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">Deb822FieldSeparatorToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3278" href="#t3278">3278</a></span><span class="t"> <span class="nam">start_of_value_entry</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3279" href="#t3279">3279</a></span><span class="t"> <span class="key">elif</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token</span><span class="op">,</span> <span class="nam">Deb822CommentElement</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3280" href="#t3280">3280</a></span><span class="t"> <span class="nam">next_token</span> <span class="op">=</span> <span class="nam">buffered_stream</span><span class="op">.</span><span class="nam">peek</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3281" href="#t3281">3281</a></span><span class="t"> <span class="com"># If the next token is a continuation line token, then this comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3282" href="#t3282">3282</a></span><span class="t"> <span class="com"># belong to a value and we might as well just start the value</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3283" href="#t3283">3283</a></span><span class="t"> <span class="com"># parsing now.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3284" href="#t3284">3284</a></span><span class="t"> <span class="com">#</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3285" href="#t3285">3285</a></span><span class="t"> <span class="com"># Note that we rely on this behaviour to avoid emitting the comment</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3286" href="#t3286">3286</a></span><span class="t"> <span class="com"># token (failing to do so would cause the comment to appear twice</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3287" href="#t3287">3287</a></span><span class="t"> <span class="com"># in the file).</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3288" href="#t3288">3288</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">next_token</span><span class="op">,</span> <span class="nam">Deb822ValueContinuationToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3289" href="#t3289">3289</a></span><span class="t"> <span class="nam">start_of_value_entry</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3290" href="#t3290">3290</a></span><span class="t"> <span class="nam">comment_element</span> <span class="op">=</span> <span class="nam">token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3291" href="#t3291">3291</a></span><span class="t"> <span class="nam">token</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3292" href="#t3292">3292</a></span><span class="t"> <span class="com"># Use next with None to avoid raising StopIteration inside a generator</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3293" href="#t3293">3293</a></span><span class="t"> <span class="com"># It won't happen, but pylint cannot see that, so we do this instead.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3294" href="#t3294">3294</a></span><span class="t"> <span class="nam">continuation_line_token</span> <span class="op">=</span> <span class="nam">cast</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3295" href="#t3295">3295</a></span><span class="t"> <span class="str">"Deb822ValueContinuationToken"</span><span class="op">,</span> <span class="nam">next</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3296" href="#t3296">3296</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3297" href="#t3297">3297</a></span><span class="t"> <span class="key">assert</span> <span class="nam">continuation_line_token</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3298" href="#t3298">3298</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3299" href="#t3299">3299</a></span><span class="t"> <span class="key">if</span> <span class="nam">token</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3300" href="#t3300">3300</a></span><span class="t"> <span class="key">yield</span> <span class="nam">token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3301" href="#t3301">3301</a></span><span class="t"> <span class="key">if</span> <span class="nam">start_of_value_entry</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3302" href="#t3302">3302</a></span><span class="t"> <span class="nam">tokens_in_value</span> <span class="op">=</span> <span class="nam">list</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">.</span><span class="nam">takewhile</span><span class="op">(</span><span class="nam">_non_end_of_line_token</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3303" href="#t3303">3303</a></span><span class="t"> <span class="nam">eol_token</span> <span class="op">=</span> <span class="nam">cast</span><span class="op">(</span><span class="str">"Deb822WhitespaceToken"</span><span class="op">,</span> <span class="nam">next</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3304" href="#t3304">3304</a></span><span class="t"> <span class="key">assert</span> <span class="nam">eol_token</span> <span class="key">is</span> <span class="key">None</span> <span class="key">or</span> <span class="nam">eol_token</span><span class="op">.</span><span class="nam">text</span> <span class="op">==</span> <span class="str">"\n"</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3305" href="#t3305">3305</a></span><span class="t"> <span class="nam">leading_whitespace</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3306" href="#t3306">3306</a></span><span class="t"> <span class="nam">trailing_whitespace</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3307" href="#t3307">3307</a></span><span class="t"> <span class="com"># "Depends:\n foo" would cause tokens_in_value to be empty for the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3308" href="#t3308">3308</a></span><span class="t"> <span class="com"># first "value line" (the empty part between ":" and "\n")</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3309" href="#t3309">3309</a></span><span class="t"> <span class="key">if</span> <span class="nam">tokens_in_value</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3309 ↛ 3323</span><span class="annotate long">line 3309 didn't jump to line 3323, because the condition on line 3309 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t3310" href="#t3310">3310</a></span><span class="t"> <span class="com"># Another special-case, "Depends: \n foo" (i.e. space after colon)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3311" href="#t3311">3311</a></span><span class="t"> <span class="com"># should not introduce an IndexError</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3312" href="#t3312">3312</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">tokens_in_value</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822WhitespaceToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3313" href="#t3313">3313</a></span><span class="t"> <span class="nam">trailing_whitespace</span> <span class="op">=</span> <span class="nam">cast</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3314" href="#t3314">3314</a></span><span class="t"> <span class="str">"Deb822WhitespaceToken"</span><span class="op">,</span> <span class="nam">tokens_in_value</span><span class="op">.</span><span class="nam">pop</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3315" href="#t3315">3315</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3316" href="#t3316">3316</a></span><span class="t"> <span class="key">if</span> <span class="nam">tokens_in_value</span> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span> </span><span class="r"><span class="annotate short">3316 ↛ 3319</span><span class="annotate long">line 3316 didn't jump to line 3319, because the condition on line 3316 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t3317" href="#t3317">3317</a></span><span class="t"> <span class="nam">tokens_in_value</span><span class="op">[</span><span class="op">-</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">Deb822WhitespaceToken</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3318" href="#t3318">3318</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3319" href="#t3319">3319</a></span><span class="t"> <span class="nam">leading_whitespace</span> <span class="op">=</span> <span class="nam">cast</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3320" href="#t3320">3320</a></span><span class="t"> <span class="str">"Deb822WhitespaceToken"</span><span class="op">,</span> <span class="nam">tokens_in_value</span><span class="op">[</span><span class="num">0</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3321" href="#t3321">3321</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3322" href="#t3322">3322</a></span><span class="t"> <span class="nam">tokens_in_value</span> <span class="op">=</span> <span class="nam">tokens_in_value</span><span class="op">[</span><span class="num">1</span><span class="op">:</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3323" href="#t3323">3323</a></span><span class="t"> <span class="key">yield</span> <span class="nam">Deb822ValueLineElement</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3324" href="#t3324">3324</a></span><span class="t"> <span class="nam">comment_element</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3325" href="#t3325">3325</a></span><span class="t"> <span class="nam">continuation_line_token</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3326" href="#t3326">3326</a></span><span class="t"> <span class="nam">leading_whitespace</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3327" href="#t3327">3327</a></span><span class="t"> <span class="nam">tokens_in_value</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3328" href="#t3328">3328</a></span><span class="t"> <span class="nam">trailing_whitespace</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3329" href="#t3329">3329</a></span><span class="t"> <span class="nam">eol_token</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3330" href="#t3330">3330</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3331" href="#t3331">3331</a></span><span class="t"> <span class="nam">comment_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3332" href="#t3332">3332</a></span><span class="t"> <span class="nam">continuation_line_token</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3333" href="#t3333">3333</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3334" href="#t3334">3334</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3335" href="#t3335">3335</a></span><span class="t"><span class="key">def</span> <span class="nam">_build_field_with_value</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3336" href="#t3336">3336</a></span><span class="t"> <span class="nam">token_stream</span><span class="op">,</span> <span class="com"># type: Iterable[Union[TokenOrElement, Deb822ValueElement]]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3337" href="#t3337">3337</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3338" href="#t3338">3338</a></span><span class="t"> <span class="com"># type: (...) -> Iterable[Union[TokenOrElement, Deb822KeyValuePairElement]]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3339" href="#t3339">3339</a></span><span class="t"> <span class="nam">buffered_stream</span> <span class="op">=</span> <span class="nam">BufferingIterator</span><span class="op">(</span><span class="nam">token_stream</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3340" href="#t3340">3340</a></span><span class="t"> <span class="key">for</span> <span class="nam">token_or_element</span> <span class="key">in</span> <span class="nam">buffered_stream</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3341" href="#t3341">3341</a></span><span class="t"> <span class="nam">start_of_field</span> <span class="op">=</span> <span class="key">False</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3342" href="#t3342">3342</a></span><span class="t"> <span class="nam">comment_element</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3343" href="#t3343">3343</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token_or_element</span><span class="op">,</span> <span class="nam">Deb822FieldNameToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3344" href="#t3344">3344</a></span><span class="t"> <span class="nam">start_of_field</span> <span class="op">=</span> <span class="key">True</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3345" href="#t3345">3345</a></span><span class="t"> <span class="key">elif</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">token_or_element</span><span class="op">,</span> <span class="nam">Deb822CommentElement</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3346" href="#t3346">3346</a></span><span class="t"> <span class="nam">comment_element</span> <span class="op">=</span> <span class="nam">token_or_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3347" href="#t3347">3347</a></span><span class="t"> <span class="nam">next_token</span> <span class="op">=</span> <span class="nam">buffered_stream</span><span class="op">.</span><span class="nam">peek</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3348" href="#t3348">3348</a></span><span class="t"> <span class="nam">start_of_field</span> <span class="op">=</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">next_token</span><span class="op">,</span> <span class="nam">Deb822FieldNameToken</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3349" href="#t3349">3349</a></span><span class="t"> <span class="key">if</span> <span class="nam">start_of_field</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3349 ↛ 3356</span><span class="annotate long">line 3349 didn't jump to line 3356, because the condition on line 3349 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t3350" href="#t3350">3350</a></span><span class="t"> <span class="com"># Remember to consume the field token</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3351" href="#t3351">3351</a></span><span class="t"> <span class="key">try</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3352" href="#t3352">3352</a></span><span class="t"> <span class="nam">token_or_element</span> <span class="op">=</span> <span class="nam">next</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t3353" href="#t3353">3353</a></span><span class="t"> <span class="key">except</span> <span class="nam">StopIteration</span><span class="op">:</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t3354" href="#t3354">3354</a></span><span class="t"> <span class="key">raise</span> <span class="nam">AssertionError</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3355" href="#t3355">3355</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3356" href="#t3356">3356</a></span><span class="t"> <span class="key">if</span> <span class="nam">start_of_field</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3357" href="#t3357">3357</a></span><span class="t"> <span class="nam">field_name</span> <span class="op">=</span> <span class="nam">token_or_element</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3358" href="#t3358">3358</a></span><span class="t"> <span class="nam">separator</span> <span class="op">=</span> <span class="nam">next</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3359" href="#t3359">3359</a></span><span class="t"> <span class="nam">value_element</span> <span class="op">=</span> <span class="nam">next</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3360" href="#t3360">3360</a></span><span class="t"> <span class="key">if</span> <span class="nam">separator</span> <span class="key">is</span> <span class="key">None</span> <span class="key">or</span> <span class="nam">value_element</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3360 ↛ 3363</span><span class="annotate long">line 3360 didn't jump to line 3363, because the condition on line 3360 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t3361" href="#t3361">3361</a></span><span class="t"> <span class="com"># Early EOF - should not be possible with how the tokenizer works</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3362" href="#t3362">3362</a></span><span class="t"> <span class="com"># right now, but now it is future-proof.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3363" href="#t3363">3363</a></span><span class="t"> <span class="key">if</span> <span class="nam">comment_element</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3364" href="#t3364">3364</a></span><span class="t"> <span class="key">yield</span> <span class="nam">comment_element</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3365" href="#t3365">3365</a></span><span class="t"> <span class="nam">error_elements</span> <span class="op">=</span> <span class="op">[</span><span class="nam">field_name</span><span class="op">]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3366" href="#t3366">3366</a></span><span class="t"> <span class="key">if</span> <span class="nam">separator</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3367" href="#t3367">3367</a></span><span class="t"> <span class="nam">error_elements</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">separator</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3368" href="#t3368">3368</a></span><span class="t"> <span class="key">yield</span> <span class="nam">Deb822ErrorElement</span><span class="op">(</span><span class="nam">error_elements</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3369" href="#t3369">3369</a></span><span class="t"> <span class="key">return</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3370" href="#t3370">3370</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3371" href="#t3371">3371</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">separator</span><span class="op">,</span> <span class="nam">Deb822FieldSeparatorToken</span><span class="op">)</span> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span> </span><span class="r"><span class="annotate short">3371 ↛ 3382</span><span class="annotate long">line 3371 didn't jump to line 3382, because the condition on line 3371 was never false</span></span></p> + <p class="pln"><span class="n"><a id="t3372" href="#t3372">3372</a></span><span class="t"> <span class="nam">value_element</span><span class="op">,</span> <span class="nam">Deb822ValueElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3373" href="#t3373">3373</a></span><span class="t"> <span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3374" href="#t3374">3374</a></span><span class="t"> <span class="key">yield</span> <span class="nam">Deb822KeyValuePairElement</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3375" href="#t3375">3375</a></span><span class="t"> <span class="nam">comment_element</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3376" href="#t3376">3376</a></span><span class="t"> <span class="nam">cast</span><span class="op">(</span><span class="str">"Deb822FieldNameToken"</span><span class="op">,</span> <span class="nam">field_name</span><span class="op">)</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3377" href="#t3377">3377</a></span><span class="t"> <span class="nam">separator</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3378" href="#t3378">3378</a></span><span class="t"> <span class="nam">value_element</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3379" href="#t3379">3379</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3380" href="#t3380">3380</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3381" href="#t3381">3381</a></span><span class="t"> <span class="com"># We had a parse error, consume until the newline.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3382" href="#t3382">3382</a></span><span class="t"> <span class="nam">error_tokens</span> <span class="op">=</span> <span class="op">[</span><span class="nam">token_or_element</span><span class="op">]</span> <span class="com"># type: List[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3383" href="#t3383">3383</a></span><span class="t"> <span class="nam">error_tokens</span><span class="op">.</span><span class="nam">extend</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">.</span><span class="nam">takewhile</span><span class="op">(</span><span class="nam">_non_end_of_line_token</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3384" href="#t3384">3384</a></span><span class="t"> <span class="nam">nl</span> <span class="op">=</span> <span class="nam">buffered_stream</span><span class="op">.</span><span class="nam">peek</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3385" href="#t3385">3385</a></span><span class="t"> <span class="com"># Take the newline as well if present</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3386" href="#t3386">3386</a></span><span class="t"> <span class="key">if</span> <span class="nam">nl</span> <span class="key">and</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">nl</span><span class="op">,</span> <span class="nam">Deb822NewlineAfterValueToken</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3387" href="#t3387">3387</a></span><span class="t"> <span class="nam">next</span><span class="op">(</span><span class="nam">buffered_stream</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3388" href="#t3388">3388</a></span><span class="t"> <span class="nam">error_tokens</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">nl</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3389" href="#t3389">3389</a></span><span class="t"> <span class="key">yield</span> <span class="nam">Deb822ErrorElement</span><span class="op">(</span><span class="nam">error_tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3390" href="#t3390">3390</a></span><span class="t"> <span class="key">else</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3391" href="#t3391">3391</a></span><span class="t"> <span class="com"># Token is not part of a field, emit it as-is</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3392" href="#t3392">3392</a></span><span class="t"> <span class="key">yield</span> <span class="nam">token_or_element</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3393" href="#t3393">3393</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3394" href="#t3394">3394</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3395" href="#t3395">3395</a></span><span class="t"><span class="key">def</span> <span class="nam">_abort_on_error_tokens</span><span class="op">(</span><span class="nam">sequence</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3396" href="#t3396">3396</a></span><span class="t"> <span class="com"># type: (Iterable[TokenOrElement]) -> Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3397" href="#t3397">3397</a></span><span class="t"> <span class="nam">line_no</span> <span class="op">=</span> <span class="num">1</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3398" href="#t3398">3398</a></span><span class="t"> <span class="key">for</span> <span class="nam">token</span> <span class="key">in</span> <span class="nam">sequence</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3399" href="#t3399">3399</a></span><span class="t"> <span class="com"># We are always called while the sequence consists entirely of tokens</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3400" href="#t3400">3400</a></span><span class="t"> <span class="key">if</span> <span class="nam">token</span><span class="op">.</span><span class="nam">is_error</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3400 ↛ 3401</span><span class="annotate long">line 3400 didn't jump to line 3401, because the condition on line 3400 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t3401" href="#t3401">3401</a></span><span class="t"> <span class="nam">error_as_text</span> <span class="op">=</span> <span class="nam">token</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">replace</span><span class="op">(</span><span class="str">"\n"</span><span class="op">,</span> <span class="str">"\\n"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3402" href="#t3402">3402</a></span><span class="t"> <span class="key">raise</span> <span class="nam">SyntaxOrParseError</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3403" href="#t3403">3403</a></span><span class="t"> <span class="str">'Syntax or Parse error on or near line {line_no}: "{error_as_text}"'</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3404" href="#t3404">3404</a></span><span class="t"> <span class="nam">error_as_text</span><span class="op">=</span><span class="nam">error_as_text</span><span class="op">,</span> <span class="nam">line_no</span><span class="op">=</span><span class="nam">line_no</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3405" href="#t3405">3405</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3406" href="#t3406">3406</a></span><span class="t"> <span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3407" href="#t3407">3407</a></span><span class="t"> <span class="nam">line_no</span> <span class="op">+=</span> <span class="nam">token</span><span class="op">.</span><span class="nam">convert_to_text</span><span class="op">(</span><span class="op">)</span><span class="op">.</span><span class="nam">count</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3408" href="#t3408">3408</a></span><span class="t"> <span class="key">yield</span> <span class="nam">token</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3409" href="#t3409">3409</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3410" href="#t3410">3410</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3411" href="#t3411">3411</a></span><span class="t"><span class="key">def</span> <span class="nam">parse_deb822_file</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3412" href="#t3412">3412</a></span><span class="t"> <span class="nam">sequence</span><span class="op">,</span> <span class="com"># type: Union[Iterable[Union[str, bytes]], str]</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3413" href="#t3413">3413</a></span><span class="t"> <span class="op">*</span><span class="op">,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3414" href="#t3414">3414</a></span><span class="t"> <span class="nam">accept_files_with_error_tokens</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3415" href="#t3415">3415</a></span><span class="t"> <span class="nam">accept_files_with_duplicated_fields</span><span class="op">=</span><span class="key">False</span><span class="op">,</span> <span class="com"># type: bool</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3416" href="#t3416">3416</a></span><span class="t"> <span class="nam">encoding</span><span class="op">=</span><span class="str">"utf-8"</span><span class="op">,</span> <span class="com"># type: str</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3417" href="#t3417">3417</a></span><span class="t"><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3418" href="#t3418">3418</a></span><span class="t"> <span class="com"># type: (...) -> Deb822FileElement</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3419" href="#t3419">3419</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3420" href="#t3420">3420</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3421" href="#t3421">3421</a></span><span class="t"><span class="str"> :param sequence: An iterable over lines of str or bytes (an open file for</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3422" href="#t3422">3422</a></span><span class="t"><span class="str"> reading will do). If line endings are provided in the input, then they</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3423" href="#t3423">3423</a></span><span class="t"><span class="str"> must be present on every line (except the last) will be preserved as-is.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3424" href="#t3424">3424</a></span><span class="t"><span class="str"> If omitted and the content is at least 2 lines, then parser will assume</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3425" href="#t3425">3425</a></span><span class="t"><span class="str"> implicit newlines.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3426" href="#t3426">3426</a></span><span class="t"><span class="str"> :param accept_files_with_error_tokens: If True, files with critical syntax</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3427" href="#t3427">3427</a></span><span class="t"><span class="str"> or parse errors will be returned as "successfully" parsed. Usually,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3428" href="#t3428">3428</a></span><span class="t"><span class="str"> working on files with this kind of errors are not desirable as it is</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3429" href="#t3429">3429</a></span><span class="t"><span class="str"> hard to make sense of such files (and they might in fact not be a deb822</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3430" href="#t3430">3430</a></span><span class="t"><span class="str"> file at all). When set to False (the default) a ValueError is raised if</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3431" href="#t3431">3431</a></span><span class="t"><span class="str"> there is a critical syntax or parse error.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3432" href="#t3432">3432</a></span><span class="t"><span class="str"> Note that duplicated fields in a paragraph is not considered a critical</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3433" href="#t3433">3433</a></span><span class="t"><span class="str"> parse error by this parser as the implementation can gracefully cope</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3434" href="#t3434">3434</a></span><span class="t"><span class="str"> with these. Use accept_files_with_duplicated_fields to determine if</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3435" href="#t3435">3435</a></span><span class="t"><span class="str"> such files should be accepted.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3436" href="#t3436">3436</a></span><span class="t"><span class="str"> :param accept_files_with_duplicated_fields: If True, then</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3437" href="#t3437">3437</a></span><span class="t"><span class="str"> files containing paragraphs with duplicated fields will be returned as</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3438" href="#t3438">3438</a></span><span class="t"><span class="str"> "successfully" parsed even though they are invalid according to the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3439" href="#t3439">3439</a></span><span class="t"><span class="str"> specification. The paragraphs will prefer the first appearance of the</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3440" href="#t3440">3440</a></span><span class="t"><span class="str"> field unless caller explicitly requests otherwise (e.g., via</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3441" href="#t3441">3441</a></span><span class="t"><span class="str"> Deb822ParagraphElement.configured_view). If False, then this method</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3442" href="#t3442">3442</a></span><span class="t"><span class="str"> will raise a ValueError if any duplicated fields are seen inside any</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3443" href="#t3443">3443</a></span><span class="t"><span class="str"> paragraph.</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3444" href="#t3444">3444</a></span><span class="t"><span class="str"> :param encoding: The encoding to use (this is here to support Deb822-like</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3445" href="#t3445">3445</a></span><span class="t"><span class="str"> APIs, new code should not use this parameter).</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3446" href="#t3446">3446</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3447" href="#t3447">3447</a></span><span class="t"> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3448" href="#t3448">3448</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">sequence</span><span class="op">,</span> <span class="op">(</span><span class="nam">str</span><span class="op">,</span> <span class="nam">bytes</span><span class="op">)</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3448 ↛ 3450</span><span class="annotate long">line 3448 didn't jump to line 3450, because the condition on line 3448 was never true</span></span></p> + <p class="pln"><span class="n"><a id="t3449" href="#t3449">3449</a></span><span class="t"> <span class="com"># Match the deb822 API.</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3450" href="#t3450">3450</a></span><span class="t"> <span class="nam">sequence</span> <span class="op">=</span> <span class="nam">sequence</span><span class="op">.</span><span class="nam">splitlines</span><span class="op">(</span><span class="key">True</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3451" href="#t3451">3451</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3452" href="#t3452">3452</a></span><span class="t"> <span class="com"># The order of operations are important here. As an example,</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3453" href="#t3453">3453</a></span><span class="t"> <span class="com"># _build_value_line assumes that all comment tokens have been merged</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3454" href="#t3454">3454</a></span><span class="t"> <span class="com"># into comment elements. Likewise, _build_field_and_value assumes</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3455" href="#t3455">3455</a></span><span class="t"> <span class="com"># that value tokens (along with their comments) have been combined</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3456" href="#t3456">3456</a></span><span class="t"> <span class="com"># into elements.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3457" href="#t3457">3457</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">tokenize_deb822_file</span><span class="op">(</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3458" href="#t3458">3458</a></span><span class="t"> <span class="nam">sequence</span><span class="op">,</span> <span class="nam">encoding</span><span class="op">=</span><span class="nam">encoding</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3459" href="#t3459">3459</a></span><span class="t"> <span class="op">)</span> <span class="com"># type: Iterable[TokenOrElement]</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3460" href="#t3460">3460</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">accept_files_with_error_tokens</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3461" href="#t3461">3461</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">_abort_on_error_tokens</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3462" href="#t3462">3462</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">_combine_comment_tokens_into_elements</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3463" href="#t3463">3463</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">_build_value_line</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3464" href="#t3464">3464</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">_combine_vl_elements_into_value_elements</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3465" href="#t3465">3465</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">_build_field_with_value</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3466" href="#t3466">3466</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">_combine_kvp_elements_into_paragraphs</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3467" href="#t3467">3467</a></span><span class="t"> <span class="com"># Combine any free-floating error tokens into error elements. We do</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3468" href="#t3468">3468</a></span><span class="t"> <span class="com"># this last as it enables other parts of the parser to include error</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3469" href="#t3469">3469</a></span><span class="t"> <span class="com"># tokens in their error elements if they discover something is wrong.</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3470" href="#t3470">3470</a></span><span class="t"> <span class="nam">tokens</span> <span class="op">=</span> <span class="nam">_combine_error_tokens_into_elements</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3471" href="#t3471">3471</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3472" href="#t3472">3472</a></span><span class="t"> <span class="nam">deb822_file</span> <span class="op">=</span> <span class="nam">Deb822FileElement</span><span class="op">(</span><span class="nam">LinkedList</span><span class="op">(</span><span class="nam">tokens</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3473" href="#t3473">3473</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3474" href="#t3474">3474</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">accept_files_with_duplicated_fields</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3475" href="#t3475">3475</a></span><span class="t"> <span class="key">for</span> <span class="nam">no</span><span class="op">,</span> <span class="nam">paragraph</span> <span class="key">in</span> <span class="nam">enumerate</span><span class="op">(</span><span class="nam">deb822_file</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="par run show_par"><span class="n"><a id="t3476" href="#t3476">3476</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">paragraph</span><span class="op">,</span> <span class="nam">Deb822DuplicateFieldsParagraphElement</span><span class="op">)</span><span class="op">:</span> </span><span class="r"><span class="annotate short">3476 ↛ 3477</span><span class="annotate long">line 3476 didn't jump to line 3477, because the condition on line 3476 was never true</span></span></p> + <p class="mis show_mis"><span class="n"><a id="t3477" href="#t3477">3477</a></span><span class="t"> <span class="nam">field_names</span> <span class="op">=</span> <span class="nam">set</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3478" href="#t3478">3478</a></span><span class="t"> <span class="nam">dup_field</span> <span class="op">=</span> <span class="key">None</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3479" href="#t3479">3479</a></span><span class="t"> <span class="key">for</span> <span class="nam">field</span> <span class="key">in</span> <span class="nam">paragraph</span><span class="op">.</span><span class="nam">keys</span><span class="op">(</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3480" href="#t3480">3480</a></span><span class="t"> <span class="nam">field_name</span><span class="op">,</span> <span class="nam">_</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">_unpack_key</span><span class="op">(</span><span class="nam">field</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3481" href="#t3481">3481</a></span><span class="t"> <span class="com"># assert for mypy</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3482" href="#t3482">3482</a></span><span class="t"> <span class="key">assert</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">field_name</span><span class="op">,</span> <span class="nam">str</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3483" href="#t3483">3483</a></span><span class="t"> <span class="key">if</span> <span class="nam">field_name</span> <span class="key">in</span> <span class="nam">field_names</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3484" href="#t3484">3484</a></span><span class="t"> <span class="nam">dup_field</span> <span class="op">=</span> <span class="nam">field_name</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3485" href="#t3485">3485</a></span><span class="t"> <span class="key">break</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3486" href="#t3486">3486</a></span><span class="t"> <span class="nam">field_names</span><span class="op">.</span><span class="nam">add</span><span class="op">(</span><span class="nam">field_name</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3487" href="#t3487">3487</a></span><span class="t"> <span class="key">if</span> <span class="nam">dup_field</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3488" href="#t3488">3488</a></span><span class="t"> <span class="nam">msg</span> <span class="op">=</span> <span class="str">'Duplicate field "{dup_field}" in paragraph number {no}'</span> </span><span class="r"></span></p> + <p class="mis show_mis"><span class="n"><a id="t3489" href="#t3489">3489</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span><span class="nam">msg</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span><span class="nam">dup_field</span><span class="op">=</span><span class="nam">dup_field</span><span class="op">,</span> <span class="nam">no</span><span class="op">=</span><span class="nam">no</span><span class="op">)</span><span class="op">)</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3490" href="#t3490">3490</a></span><span class="t"> </span><span class="r"></span></p> + <p class="run"><span class="n"><a id="t3491" href="#t3491">3491</a></span><span class="t"> <span class="key">return</span> <span class="nam">deb822_file</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3492" href="#t3492">3492</a></span><span class="t"> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3493" href="#t3493">3493</a></span><span class="t"> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t3494" href="#t3494">3494</a></span><span class="t"><span class="key">if</span> <span class="nam">__name__</span> <span class="op">==</span> <span class="str">"__main__"</span><span class="op">:</span> <span class="com"># pragma: no cover</span> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t3495" href="#t3495">3495</a></span><span class="t"> <span class="key">import</span> <span class="nam">doctest</span> </span><span class="r"></span></p> + <p class="pln"><span class="n"><a id="t3496" href="#t3496">3496</a></span><span class="t"> </span><span class="r"></span></p> + <p class="exc show_exc"><span class="n"><a id="t3497" href="#t3497">3497</a></span><span class="t"> <span class="nam">doctest</span><span class="op">.</span><span class="nam">testmod</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> +</main> +<footer> + <div class="content"> + <p> + <a id="prevFileLink" class="nav" href="d_e9c451f4ae334f76_locatable_py.html">« prev</a> + <a id="indexLink" class="nav" href="index.html">^ index</a> + <a id="nextFileLink" class="nav" href="d_e9c451f4ae334f76_tokens_py.html">» next</a> + + <a class="nav" href="https://coverage.readthedocs.io/en/7.2.7">coverage.py v7.2.7</a>, + created at 2024-04-07 12:14 +0200 + </p> + </div> +</footer> +</body> +</html> |